PowerShell の -notmatch ‘\__pycache__\’ で「Invalid pattern … Unrecognized escape sequence \_」。-notlike で直す

Get-ChildItem -Recurse の結果から Python の __pycache__ を外そうとして、Where-Object { $_.FullName -notmatch '\__pycache__\' } と書いたら、Unrecognized escape sequence \_ で落ちました。
-notmatch は文字列の比較ではなく正規表現なので、パス区切りのつもりの \ がエスケープとして読まれたのが原因です。
ワイルドカードで比べる -notlike '*__pycache__*' に替えたら通りました。

症状

本番の写しを作る前後で、対象のファイルのハッシュを控えるスクリプトを書いていました。その中の 1 行です。

Get-ChildItem -LiteralPath "$R\tools\analytics\$sub" -File -Recurse |
    Where-Object { $_.FullName -notmatch '\__pycache__\' } |
    ForEach-Object { $list.Add($_.FullName) }

流すと、こう出て止まります。

Where-Object: C:\...\hashsnap.ps1:7
Line |
   7 |  … -Recurse | Where-Object { $_.FullName -notmatch '\__pycache__\' } | …
     |               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | Invalid pattern '\__pycache__\' at offset 2. Unrecognized escape sequence \_.

環境

  • Windows 11
  • PowerShell 7(pwsh -NoProfile -File で実行)

原因

PowerShell の比較演算子は、種類によって右辺の読み方が違います。

演算子 右辺の読み方 \ の扱い
-match / -notmatch .NET の正規表現 エスケープの始まり
-like / -notlike ワイルドカード(* と ?) ただの文字

'\__pycache__\' を正規表現として読むと、先頭の \_ は「_ をエスケープ」になります。.NET の正規表現は知らないエスケープを受け付けないので、2 文字目(offset 2)で Unrecognized escape sequence \_ になります。

Windows のパスを思い浮かべて \ で囲んだのが、正規表現の側ではエラーになったわけです。

解決手順

  1. -notmatch を -notlike に替え、前後を * で挟みます。

powershell
Get-ChildItem -LiteralPath "$R\tools\analytics\$sub" -File -Recurse |
Where-Object { $_.FullName -notlike '*__pycache__*' } |
ForEach-Object { $list.Add($_.FullName) }

  1. スクリプトがほかの道具で作ったファイルなら、その行だけを置き換えても構いません。今回は Git Bash の sed で直しました。

bash
sed -i "s/-notmatch '[^']*__pycache__[^']*'/-notlike '*__pycache__*'/" hashsnap.ps1
grep -n pycache hashsnap.ps1

  1. 流し直して、一覧が取れることを確かめます。今回はエラーが消えて、対象 65 件の控えが取れました。

再発防止・気づき

  • 「この文字が入っているか」を見たいだけなら、-like / -notlike の方が \ や . を気にしなくて済みます。
  • -match を使うときは、右辺が正規表現だということを忘れないこと。Windows のパスは \ だらけなので、そのまま書くと今回のように落ちるか、落ちなくても思った意味になりません。

関連

この記事を書いた人

realine

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

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