PowerShell脚本新手求助：批量替换大型JSON文件中百余个占位符字符串的方法

Great question! When you're dealing with 100+ placeholders, manually chaining -replace operations or defining individual variables is absolutely not scalable. Here are two clean, maintainable solutions that will make this task trivial:

方法1：使用PowerShell哈希表管理替换项 #

You can store all your placeholder-replacement pairs in a single hashtable, then loop through it to apply every replacement in one go. This keeps your code organized and easy to update:

$filePath = ".\project\data.json"

# 定义所有占位符与替换值的键值对
$replacements = @{
    "%%ABOUT_MESSAGE_TO_REPLACE%%" = "My name is Andrew"
    "%%PHONE_NUMBER_REPLACE%%" = "0045864188"
    "%%NAME_FRIEND_TO_REPLACE%%" = "John Doe"
    "%%URL_PICTURE_REPLACE%%" = "http://my-custom-image.com/32x32"
    "%%EMAIL_REPLACE%%" = "anderson.jimenez@bristo.com"
    "%%REPLACE_TAG%%" = "custom-tag"
    "%%ADDRESS_REPLACE%%" = "123 Main Street, Anytown, USA, 12345"
    # 继续添加剩余100+个占位符...
}

# 读取整个JSON文件为单个字符串（避免换行符导致的替换问题）
$content = Get-Content $filePath -Raw

# 遍历哈希表执行所有替换
foreach ($placeholder in $replacements.Keys) {
    # 使用[regex]::Escape()转义占位符中的正则特殊字符（比如%）
    $content = $content -replace [regex]::Escape($placeholder), $replacements[$placeholder]
}

# 将修改后的内容写回文件
$content | Set-Content $filePath

关键说明： #

• -Raw参数确保将整个文件读取为单一字符串，避免替换过程中因换行符拆分内容导致的错误。
• [regex]::Escape()是必不可少的：你的占位符包含%这类正则中有特殊含义的字符，转义后能保证占位符被精确匹配。

方法2：使用外部JSON配置文件（更适合大量替换场景） #

如果希望将替换数据与脚本逻辑分离（无需修改代码就能更新替换规则），可以用外部JSON配置文件存储所有占位符和对应值：

首先，在脚本同目录下创建replacements.json文件：

{
    "%%ABOUT_MESSAGE_TO_REPLACE%%": "My name is Andrew",
    "%%PHONE_NUMBER_REPLACE%%": "0045864188",
    "%%NAME_FRIEND_TO_REPLACE%%": "John Doe",
    "%%URL_PICTURE_REPLACE%%": "http://my-custom-image.com/32x32",
    "%%EMAIL_REPLACE%%": "anderson.jimenez@bristo.com",
    "%%REPLACE_TAG%%": "custom-tag",
    "%%ADDRESS_REPLACE%%": "123 Main Street, Anytown, USA, 12345"
}

然后用以下PowerShell脚本加载配置并执行替换：

$filePath = ".\project\data.json"
$configPath = ".\replacements.json"

# 加载JSON配置并转换为哈希表
# PowerShell 7+版本可直接用：
$replacements = Get-Content $configPath -Raw | ConvertFrom-Json -AsHashtable

# 若使用Windows PowerShell 5.1（无法使用PowerShell 7），则用以下代码转换：
# $replacementsObj = Get-Content $configPath -Raw | ConvertFrom-Json
# $replacements = @{}
# foreach ($prop in $replacementsObj.PSObject.Properties) {
#     $replacements[$prop.Name] = $prop.Value
# }

# 读取并修改目标JSON文件
$content = Get-Content $filePath -Raw
foreach ($placeholder in $replacements.Keys) {
    $content = $content -replace [regex]::Escape($placeholder), $replacements[$placeholder]
}

$content | Set-Content $filePath

优势说明： #

• 这种方式将替换数据与脚本逻辑解耦，你可以直接编辑replacements.json（甚至用普通文本编辑器）来添加或修改占位符，无需改动PowerShell代码。
• 对于100+个替换项来说，这种方式管理起来更轻松——你甚至可以把JSON文件分享给他人更新，不需要让他们接触脚本本身。

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