PowerShell V5.1：递归搜索文件字符串时排除各类注释代码

实现脚本 #

直接用这段脚本就能搞定，你可以根据自己的需求调整参数：

# 配置参数
$targetString = "你的目标字符串"
$searchPath = "要搜索的文件夹路径"
$fileExtensions = @(".cs", ".js", ".cpp") # 按需添加要搜索的文件后缀

# 递归遍历目标文件夹下的指定文件
Get-ChildItem -Path $searchPath -Recurse -Include $fileExtensions | ForEach-Object {
    $filePath = $_.FullName
    $content = Get-Content -Path $filePath -Raw
    $inMultiLineComment = $false
    $matchedLines = @()

    # 逐行处理内容，先清注释再找目标
    $content -split "`n" | ForEach-Object {
        $currentLine = $_
        # 处于多行注释中时，先找结束标记
        if ($inMultiLineComment) {
            if ($currentLine -match "\*/") {
                # 截掉从开头到注释结束的部分
                $currentLine = $currentLine -replace "^.*?\*/", ""
                $inMultiLineComment = $false
            } else {
                # 整行都在多行注释里，直接跳过
                return
            }
        }

        # 处理当前行内的多行注释起始标记
        while ($currentLine -match "/\*") {
            $prePart = $matches[0].Before
            $postPart = $matches[0].After
            if ($postPart -match "\*/") {
                # 注释在当前行内结束，拼接前后非注释内容
                $currentLine = $prePart + $postPart -replace "^.*?\*/", ""
            } else {
                # 注释跨到下一行，只保留注释前的内容，标记进入多行注释状态
                $currentLine = $prePart
                $inMultiLineComment = $true
                break
            }
        }

        # 不在多行注释时，处理单行注释
        if (-not $inMultiLineComment) {
            # 删掉从//开始到行尾的所有内容
            $currentLine = $currentLine -replace "//.*$", ""
            # 清掉行尾空格，避免空行干扰
            $currentLine = $currentLine.TrimEnd()
            # 检查处理后的行是否包含目标字符串
            if ($currentLine -match [regex]::Escape($targetString)) {
                $matchedLines += "行号: $($_.ReadCount) 内容: $currentLine"
            }
        }
    }

    # 输出当前文件的匹配结果
    if ($matchedLines.Count -gt 0) {
        Write-Host "`n找到匹配文件: $filePath"
        $matchedLines | ForEach-Object { Write-Host $_ }
    }
}

关键细节说明 #

• 多行注释处理：用$inMultiLineComment变量跟踪是否处于多行注释块，碰到/*就检查后续是否有*/，处理跨行的情况，确保不会把注释里的内容当成有效代码。
• 单行注释处理：用正则//.*$直接删除行内所有从//开始的内容，简单高效。
• 目标字符串转义：用[regex]::Escape()包裹目标字符串，就算目标里有.、*这类正则特殊字符，也不会影响匹配结果。
• 文件类型筛选：通过$fileExtensions指定要搜索的后缀，比如只搜.cs、.js，避免处理日志、文档这类无关文件。

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