PowerShell の Parser::ParseFile で「[ref] は、存在しない変数には適用できません」。先に $null を入れておけば通る

書き換えた .ps1 を流す前に、[System.Management.Automation.Language.Parser]::ParseFile で構文エラーの数を数えようとしたら、チェックそのものが [ref] は、存在しない変数には適用できません。 で落ちました。
[ref] に渡した変数を、その前に作っていなかったのが原因です。
$tk = $null; $e = $null を先に書いておくだけで通ります。

症状

スクリプトを書き換えて新しい版を作り、そのまま構文チェックまで流す、という一続きの処理を書いていました。その最後の方です。

$null = [System.Management.Automation.Language.Parser]::ParseFile($dst, [ref]$tk, [ref]$e)
"parseErrors=$($e.Count)"

結果はこうでした。

InvalidOperation:
Line |
  10 |  $null=[System.Management.Automation.Language.Parser]::ParseFile($dst, …
     |  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | [ref] は、存在しない変数には適用できません。
parseErrors=0

厄介なのは、エラーの後に parseErrors=0 が出ていることです。ParseFile が動いていないので $e は空のままで、$e.Count が 0 になっているだけです。ぱっと見ると「構文エラー 0 件」に見えてしまいます。

環境

  • Windows 11
  • PowerShell 7(pwsh -NoProfile)

原因

ParseFile の 2 つ目と 3 つ目の引数は、結果を書き戻してもらうための [ref](参照渡し)です。

PowerShell の [ref]$変数 は、その変数がまだ一度も作られていないとエラーになります。今回のスクリプトでは $tk も $e もそれより前に出てこなかったので、ParseFile を呼ぶ前の段階で止まっていました。

解決手順

  1. ParseFile を呼ぶ前に、[ref] で渡す変数を $null で作っておきます。

powershell
$tk = $null; $e = $null
$null = [System.Management.Automation.Language.Parser]::ParseFile('C:\path\to\script.ps1', [ref]$tk, [ref]$e)
"parseErrors=$($e.Count)"

  1. 流し直して、エラーが出ずに件数だけが出ることを確かめます。今回は parseErrors=0 だけが出て、新しい版の構文に問題が無いことを確かめられました。

再発防止・気づき

  • [ref] を使うときは、すぐ上の行で変数を作る、を癖にしておくと迷いません。
  • 「エラー 0 件」を表示する作りのチェックは、チェック自体が失敗しても 0 と出ることがあります。件数だけを見ずに、その前にエラーが出ていないかも見ること。

関連

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方