PowerShell脚本字符串替换问题：实现Key与输入字符串精确匹配

方法1：直接使用哈希表精确匹配（推荐） #

原脚本误用正则替换导致子串匹配，我们需要的是整个输入字符串与Key的精确匹配，直接用哈希表的键查找就能解决，无需正则：

$path = 'Path\To\CSV\file.csv'
$matrixPath = 'Path\To\Matrix\file.csv'

# 加载映射矩阵到哈希表
$matrix = @{}
Import-Csv $matrixPath | ForEach-Object {
    $matrix[$_.Key] = $_.Value
}

# 处理待重命名数据
$data = Import-Csv $path -Header UDFName | ForEach-Object {
    # 精确查找对应Value，找不到则保留原字符串（可按需调整）
    $_.UDFName = $matrix[$_.UDFName] ?? $_.UDFName
    $_
}

# 输出结果到文件（与原脚本逻辑一致，去掉自动生成的表头和引号）
$data | ConvertTo-Csv | Select-Object -Skip 2 | Set-Content $path

效果说明 #

• YellowString会直接匹配哈希表中的YellowString键，返回Test 3，不会再匹配Yellow子串
• Jane(ABC)精确匹配对应键返回Test 4，不会出现Test 4(ABC)的错误
• 对于不存在的键（如Jane(abc)），会保留原字符串，可根据需求改为返回空值或其他默认值

方法2：修改正则实现全字符串匹配 #

如果必须用正则方案，需做两个关键修改：

1. 给每个正则模式加^（字符串开头）和$（字符串结尾）锚点，确保匹配整个字符串
2. 将较长的Key放在正则前面，避免短Key先匹配长Key的前缀

修改后的脚本：

$path = 'Path\To\CSV\file.csv'
$matrixPath = 'Path\To\Matrix\file.csv'

$data = Import-Csv $path -Header UDFName

$matrix = @{}
# 按Key长度倒序排序，保证长Key优先匹配
$re = Import-Csv $matrixPath | Sort-Object { $_.Key.Length } -Descending | ForEach-Object {
    $matrix[$_.Key] = $_.Value
    # 给转义后的Key加上全字符串匹配锚点
    '^' + [regex]::Escape($_.Key) + '$'
}
$re = $re -join '|' -as [regex]

$data | ForEach-Object {
    # 仅匹配整个字符串，找不到则保留原字符串
    $udf_rename = if ($re.IsMatch($_.UDFName)) {
        $re.Replace($_.UDFName, { $matrix[$args[0].Value.TrimStart('^').TrimEnd('$')] })
    } else {
        $_.UDFName
    }
    $_.UDFName = $udf_rename
    $_
} | ConvertTo-Csv | Select-Object -Skip 2 | Set-Content $path

效果说明 #

• ^和$确保只有整个字符串与Key完全一致时才会替换
• 按Key长度倒序排序，保证YellowString先于Yellow被匹配，避免短Key拦截长Key

原脚本问题分析 #

• 正则无锚点，会匹配输入字符串中的任意子串，比如Yellow会匹配YellowString的前6个字符，导致替换后变成Test 3String
• 正则匹配顺序按CSV中Key的顺序，短Key会优先匹配长Key的前缀，加剧了部分替换的问题

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