PowerShell脚本中仅替换变量定义的首次出现行

核心思路是跟踪已处理的变量名，遍历脚本内容时，仅对行首出现的、未处理过的变量定义进行替换，注释行和已处理过的变量行直接保留。

以下是实现脚本：

# 定义要替换的变量映射（键是变量名，值是新值）
$variableReplacements = @{
    'SomeVar1' = '"F:\different\path\to\file\a"'
    'SomeVar2' = '"F:\different\path\to\file\b"'
}

# 读取原始脚本内容
$scriptContent = Get-Content -Path 'path/to/your/original/script.ps1' -Raw

# 拆分内容为行，并初始化已处理变量集合
$lines = $scriptContent -split "`r?`n"
$processedVars = [System.Collections.Generic.HashSet[string]]::new()

$modifiedLines = foreach ($line in $lines) {
    # 匹配行首的变量定义（忽略前置空白，匹配$VarName = "value"格式）
    if ($line -match '^\s*\$(\w+)\s*=\s*.+$' -and -not $line.TrimStart().StartsWith('#')) {
        $varName = $matches[1]
        # 如果这个变量还没处理过，并且在替换映射中存在，就替换值
        if ($processedVars.Add($varName) -and $variableReplacements.ContainsKey($varName)) {
            # 替换等号后的内容为新值
            $line -replace '^\s*\$(\w+)\s*=\s*.+$', "`$$1 = $($variableReplacements[$varName])"
        }
        else {
            # 已处理过或不在替换列表中，直接保留原行
            $line
        }
    }
    else {
        # 注释行或非变量定义行，直接保留
        $line
    }
}

# 将修改后的行合并并写入文件
$modifiedLines -join "`r`n" | Set-Content -Path 'path/to/your/modified/script.ps1' -Encoding UTF8

脚本说明： #

• 变量映射：$variableReplacements 里定义需要替换的变量名和对应的新值，按需修改即可。
• 行匹配逻辑：用正则表达式匹配行首的变量定义，同时排除以#开头的注释行（包括前置空白后的注释）。
• 去重处理：用HashSet记录已经处理过的变量名，确保每个变量只替换行首首次出现的那一行。
• 替换规则：仅替换等号后的内容，保留变量名和行首的空白格式，避免破坏原脚本的缩进。

测试验证： #

将你的原始脚本内容放入测试文件，运行上述脚本后，会得到你期望的结果：仅替换$SomeVar1和$SomeVar2的首次行首定义，注释行和重复的变量行完全保留。

内容的提问来源于stack exchange，提问作者Daniel Procházka