PowerShell哈希表字符串元素替换无效问题排查

问题背景 #

你有一个哈希表$wImages，键为.png后缀的文件名，值均为1：

Name                           Value
----                           -----
abc.png         1
def.png         1
ghk.png         1
xyz.png         1

想要将所有键的后缀改为.jpg，但执行以下代码后哈希表毫无变化：

$wImages | ForEach-Object {$_ -replace 'png','jpg'}

问题原因 #

1. $_的类型不是字符串：当哈希表通过管道传给ForEach-Object时，$_代表的是DictionaryEntry类型的键值对对象，不是单纯的键字符串。直接对这个对象用-replace，只会返回该对象的字符串表示（比如[abc.png, 1]）并替换其中的png，但这完全不会影响原哈希表的内容。
2. 哈希表的键不可直接修改：哈希表的键是只读属性，无法直接编辑已存在的键名，必须通过「删除旧键 + 添加新键」的方式实现修改。

解决方法 #

正确的做法是先提取所有需要修改的旧键，遍历每个旧键生成新键，将旧键对应的值赋值给新键，最后删除旧键：

# 先获取所有.png后缀的键（提前存到列表，避免遍历哈希表时修改导致的异常）
$oldKeys = $wImages.Keys | Where-Object { $_ -like '*.png' }

foreach ($key in $oldKeys) {
    # 精准替换后缀（用$匹配字符串末尾，避免误替换文件名中包含png的情况）
    $newKey = $key -replace 'png$', 'jpg'
    # 将旧键的值赋值给新键
    $wImages[$newKey] = $wImages[$key]
    # 删除旧键
    $wImages.Remove($key)
}

执行完这段代码后，$wImages的键就会全部变为.jpg后缀，符合你的需求。

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