Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要)
要点
PS 5.1 はBOMなしUTF-8スクリプトをANSIとして読むため日本語で構文エラーになる。BOMを付ける。変数名は大文字小文字を区別しないので $P と $p が衝突する。
症状と原因
| 症状 | 原因 | 対処 |
|---|---|---|
The string is missing the terminator などの構文エラー | PS 5.1 は BOM なし UTF-8 のスクリプトを ANSI(CP932)として読む | スクリプト先頭に UTF-8 BOM を付ける(例: printf '\xEF\xBB\xBF' を先頭に書く) |
Cannot convert 'System.String[]' など、変数の値が勝手に変わる | PowerShell の変数名は大文字小文字を区別しない。$P とループ変数 $p が同じ変数になる | $proj と $pp のように別名にする |
-f 演算子で Error formatting a string | 連結式をそのまま左辺に置いた | 先に変数へ入れてから -f を使う |
ファイル書き込み
Out-File/>は UTF-8(BOMあり)、Set-Contentは ANSI が既定。ほかのツールが読むファイルは-Encoding utf8を明示するか、[IO.File]::WriteAllText($path, $text, (New-Object Text.UTF8Encoding($false)))で BOM なしにする。- 読み込みは
Get-Content -Encoding UTF8(BOM の有無どちらも読める)。
Claude Code 上での注意
- 既存ファイルを PowerShell で上書きしようとして auto mode に拒否された例がある(Irreversible Local Destruction)。既存ファイルの変更は Read → Edit ツールで行う。