PowerShell使用-match匹配"ErrorCode":1出现误匹配的问题排查

我最近写了一段PowerShell脚本，想找出包含"ErrorCode":1的.data文件，但遇到了一个奇怪的问题：有些完全没有ErrorCode字样的文件也被纳入了匹配结果，比如某个文件的内容是404错误的HTML：

Not Found

---

HTTP Error 404. The requested resource is not found.

我的脚本代码是这样的：

$fileNames = Get-ChildItem -Path $scriptPath -Recurse -Include *.data
$FoldersToRename = @() #initialize as array
foreach ($file in $fileNames) {
 If (Get-Content $file | %{$_ -match '"ErrorCode":1'})
 # If (Get-Content $file | %{$_ -match '"ErrorCode": [1-9]\d*'})
 {
 $FoldersToRename += Split-Path $file
 echo $file
 }
}

问题根源分析 #

核心问题出在PowerShell处理数组与布尔条件判断的逻辑上：

• Get-Content $file会把文件的每一行作为单独的字符串输出，传递给ForEach-Object（简写%）。
• 对每一行执行$_ -match '"ErrorCode":1'时，会返回一个布尔值（$true或$false），最终所有行的结果会组成一个布尔值数组。
• 当把这个数组放到If条件中时，PowerShell的规则是：非空的集合/数组会被直接判定为$true——不管数组里的元素是$true还是$false。

也就是说，只要文件有内容（哪怕所有行都不匹配目标字符串），ForEach-Object返回的就是一个由$false组成的非空数组，If会把这个数组视为$true，从而错误地执行代码块，把这类文件纳入结果。

解决方案 #

有两种简单的修复方式：

方式1：使用Select-String（推荐）

Select-String专门用于在文本中查找匹配的模式，找到匹配时会返回MatchInfo对象，找不到则返回空值。If会把空值判定为$false，完美符合需求：

$fileNames = Get-ChildItem -Path $scriptPath -Recurse -Include *.data
$FoldersToRename = @()
foreach ($file in $fileNames) {
    if (Get-Content $file | Select-String -Pattern '"ErrorCode":1') {
        $FoldersToRename += Split-Path $file
        Write-Output $file
    }
}

方式2：检查数组中是否存在$true

如果坚持用-match，可以在布尔数组后加上-contains $true，只有当数组里至少有一个$true时，条件才会成立：

$fileNames = Get-ChildItem -Path $scriptPath -Recurse -Include *.data
$FoldersToRename = @()
foreach ($file in $fileNames) {
    if ((Get-Content $file | ForEach-Object { $_ -match '"ErrorCode":1' }) -contains $true) {
        $FoldersToRename += Split-Path $file
        Write-Output $file
    }
}

额外优化建议 #

• 用Write-Output代替echo（echo是Write-Output的别名，正式脚本中用全名更清晰）。
• 对于大文件，Get-Content会加载所有内容到内存，可以直接用Select-String -Path $file读取文件，效率更高：

# 更高效的写法：直接用Select-String读取文件
$fileNames = Get-ChildItem -Path $scriptPath -Recurse -Include *.data
$FoldersToRename = @()
foreach ($file in $fileNames) {
    if (Select-String -Path $file -Pattern '"ErrorCode":1') {
        $FoldersToRename += Split-Path $file
        Write-Output $file
    }
}

内容的提问来源于stack exchange，提问作者Bhaumik Bhatt