寻求可移除脚本中所有注释的功能实现函数

实现前先避坑：不要直接写裸正则全局替换，很容易把字符串字面量里的#、<#、#>误判成注释标记删掉，比如Write-Host "打印#符号"里的#属于正常输出内容，必须保留。

下面给两种可落地的实现，按需选择即可：

方案1：基于PowerShell官方语法解析器实现（推荐，无错判） #

这个方案用PowerShell自带的语言解析器把脚本拆成独立语法标记，直接筛掉注释类标记再拼接内容，完全遵循原生语法规则，不会出现上下文误判，嵌套块注释、here-string、带特殊字符的字符串场景都能正确处理。

function Remove-ScriptComment {
    param(
        [Parameter(Mandatory, ValueFromPipeline)]
        [string]$ScriptContent
    )

    $tokens = $null
    $parseErrors = $null
    # 调用官方解析器生成语法token列表
    [System.Management.Automation.Language.Parser]::ParseInput(
        $ScriptContent,
        [ref]$tokens,
        [ref]$parseErrors
    ) | Out-Null

    $stringBuilder = New-Object System.Text.StringBuilder
    $lastEndOffset = 0

    # 遍历所有非注释token，按原始位置拼接
    foreach ($validToken in $tokens | Where-Object { $_.Kind -ne 'Comment' }) {
        # 保留token之间的原有空白
        $gapLength = $validToken.Extent.StartOffset - $lastEndOffset
        if ($gapLength -gt 0) {
            [void]$stringBuilder.Append($ScriptContent.Substring($lastEndOffset, $gapLength))
        }
        [void]$stringBuilder.Append($validToken.Extent.Text)
        $lastEndOffset = $validToken.Extent.EndOffset
    }
    # 拼接最后一段剩余内容
    if ($lastEndOffset -lt $ScriptContent.Length) {
        [void]$stringBuilder.Append($ScriptContent.Substring($lastEndOffset))
    }

    return $stringBuilder.ToString()
}

调用方式示例：

$cleanScript = Get-Content .\target.ps1 -Raw | Remove-ScriptComment
$cleanScript | Set-Content .\target_clean.ps1

方案2：正则快速实现（仅适合简单场景） #

如果你处理的脚本结构非常简单，确认不存在字符串里包含注释标记的情况，可以用正则快速实现，注意匹配优先级：先匹配块注释，再匹配单行注释，避免块注释里的#被误识别为单行注释开头。

function Remove-ScriptCommentSimple {
    param(
        [Parameter(Mandatory, ValueFromPipeline)]
        [string]$ScriptContent
    )
    # 正则规则：单行模式匹配<#包裹的块注释，多行模式匹配#开头到行尾的单行注释
    $pattern = '(?s)<#.*?#>|(?m)#.*?$'
    return [regex]::Replace($ScriptContent, $pattern, '')
}

这个方案的已知缺陷：

• 会误删单/双引号字符串、here-string里的注释标记
• 无法正确识别嵌套的块注释
• 未加引号的参数值里如果包含注释标记，也会被错误清除

使用提示 #

• 生产环境处理正式脚本优先选方案1，不需要自己处理各种语法边界case
• 清理完成后建议把结果再传给解析器做一次语法校验，避免清理过程破坏脚本逻辑
• 不要用简单逐行字符串替换的方式实现，块注释跨多行时逐行处理很容易漏删或者误删

内容的提问来源于stack exchange，提问作者I am Jakoby