Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要)

確定 AI活用トラブル解決 更新 2026-09-25
要点

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 ツールで行う。