PowerShell「null 配列内にインデックス アクセスすることはできません」Select-String の Matches.Groups[1] で出る原因と直し方

複数のファイルから Select-String で版番号を抜き出していたら、「null 配列内にインデックス アクセスすることはできません」が何行も出ました。
原因は、目当ての行が無いファイルが混ざっていたことです。Select-String が何も返さないので、その先の .Matches.Groups[1] が null へのインデックスになります。
結果をいったん変数に入れて、if でマッチした場合だけ値を取るように書き直したら、エラーは消えました。

症状

フォルダの下にあるスクリプトを探して、中の SCRIPT_VERSION = '…' の値を一覧にしようとしました。最初に書いたのはこうです(パスと変数名は一般化しています)。

Get-ChildItem -Path F:\ -Filter script.py -Recurse -ErrorAction SilentlyContinue -Depth 5 |
  ForEach-Object {
    $v = (Select-String -Path $_.FullName -Pattern "^SCRIPT_VERSION = '([^']+)'" | Select-Object -First 1).Matches.Groups[1].Value
    "{0} | {1} | {2}" -f $_.LastWriteTime.ToString('yyyy-MM-dd HH:mm'), $v, $_.FullName
  }

実行すると、ファイルごとに次のエラーが出ました。

InvalidOperation: null 配列内にインデックス アクセスすることはできません。
2026-01-30 12:49 |  | F:\...\script.py

厄介なのは、処理が止まらないことです。エラーの次の行には一覧がそのまま出て、版の欄だけが空になります。エラーを読み飛ばすと「版が書かれていないファイル」と「取り出しに失敗したファイル」の見分けがつきません。

環境

  • Windows の PowerShell(エラーが InvalidOperation: で始まる表示)
  • Get-ChildItem -Recurse で集めたファイルに、Select-String を1件ずつ当てる書き方

原因

エラーが出たのは、正規表現が1行もマッチしないファイルでした。古い版のファイルが多く、SCRIPT_VERSION = '…' の行が無かったとみられます。

マッチが無いと、Select-String … | Select-Object -First 1 の結果は null です。そこから先をつなぐと、こう進みます。

式 マッチしたとき マッチしないとき
( … ).Matches マッチの一覧 null
.Groups グループの一覧 null
[1] 1番目のグループ null にインデックス → エラー

プロパティを読むだけなら null のまま進みますが、最後の [1] で null に添え字を付けることになり、ここでエラーになります。

解決手順

  1. Select-String の結果を、いったん変数に入れます。
  2. if で、マッチがあったときだけ .Matches[0].Groups[1].Value を取ります。無いときは目印の文字(ここでは -)を入れます。
Get-ChildItem -Path F:\ -Filter "script*.py" -Recurse -ErrorAction SilentlyContinue |
  ForEach-Object {
    $m = Select-String -Path $_.FullName -Pattern "^SCRIPT_VERSION = '([^']+)'" | Select-Object -First 1
    "{0} | {1} | {2}" -f $_.LastWriteTime.ToString('yyyy-MM-dd HH:mm'), ($(if($m){$m.Matches[0].Groups[1].Value}else{'-'})), $_.FullName
  } | Select-Object -First 20

書き直した後は、エラーが出なくなりました。版の行が無いファイルは、次のように - と出ます。

2026-11-09 01:37 | - | F:\...\script.py

空欄ではなく - が入るので、「この版には行が無い」とひと目で分かります。

再発防止・気づき

  • (コマンド).A.B[1].C のように、結果が空になりうるコマンドへ直接つなげない。いったん変数に受けて、空かどうかを先に見る。
  • このエラーは処理を止めないので、一覧の空欄が「値が無い」のか「取り出しに失敗した」のか分からなくなります。無いときに入れる目印(- など)を自分で決めておくと、結果を読み違えません。
  • 古いファイルと新しいファイルが混ざるフォルダを調べるときほど、「マッチしないファイルがある」前提で書いておくのが安全です。

この記事を書いた人

realine

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

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