如何在PowerShell的ForEach-Object函数中添加计数器

实现思路 #

核心是在替换执行的节点同步统计匹配次数，有两种常用实现方案：

• 方案1：逐行统计当前行匹配数累加后再执行替换，逻辑简单易读，适合普通字符串匹配场景
• 方案2：通过正则匹配评估器处理，每次触发匹配时自动计数+1同时返回替换值，兼容带正则规则的匹配需求，计数精度更高，还支持整文件读取优化性能

通用实现代码（支持正则/普通字符串匹配） #

# 初始化替换总计数器
[int]$totalReplaceCount = 0
# 按需修改以下三个变量的值
$oldValue = "需要替换的原始内容"
$newValue = "替换后的目标内容"
$filePath = "目标文件的完整路径"

Get-Content -Path $filePath -Raw | ForEach-Object {
    # [regex]::Escape 作用是转义普通字符串里的正则特殊字符，若$oldValue本身是正则规则可删掉这层转义
    [regex]::Replace($_, [regex]::Escape($oldValue), {
        param($matchItem)
        $global:totalReplaceCount += 1
        return $newValue
    })
} | Set-Content -Path $filePath -Encoding UTF8

# 输出最终统计结果
Write-Host "本次共完成 $totalReplaceCount 处替换"

逐行处理版本（适合大文件避免内存占用过高） #

[int]$totalReplaceCount = 0
$oldValue = "需要替换的原始内容"
$newValue = "替换后的目标内容"
$filePath = "目标文件的完整路径"
$escapedOldValue = [regex]::Escape($oldValue)

Get-Content -Path $filePath | ForEach-Object {
    # 先统计当前行匹配数量
    $currentLineMatchCount = ([regex]::Matches($_, $escapedOldValue)).Count
    $totalReplaceCount += $currentLineMatchCount
    # 输出替换后的行内容到下游管道
    $_ -replace $escapedOldValue, $newValue
} | Set-Content -Path $filePath -Encoding UTF8

Write-Host "本次共完成 $totalReplaceCount 处替换"

注意事项 #

• 可以根据文件原编码调整Set-Content的-Encoding参数，比如改为Default使用系统默认编码，避免出现乱码
• 如果oldValue存在大小写匹配需求，可以在正则替换时增加忽略大小写的配置

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