在PowerShell中调用ExpandString时如何转义字符串变量？

这个问题的核心在于ExpandString是为PowerShell字符串扩展设计的，它完全不考虑JSON的语法规则——当变量值包含双引号、反斜杠这类JSON特殊字符时，直接替换会破坏JSON的结构，导致ConvertFrom-Json解析失败。

要解决这个问题，我们需要在替换变量时，主动将变量值转义为JSON兼容的格式。这里提供一个可靠的实现思路：

1. 用正则匹配模板中所有${var_name}格式的变量占位符
2. 对每个变量值，利用ConvertTo-Json自动处理JSON特殊字符的转义
3. 将转义后的变量值替换回模板，再进行JSON解析

完整代码示例 #

$inputFile = "your-template.json"
[string]$jsonText = Get-Content $inputFile -Raw
if ([string]::IsNullOrWhiteSpace($jsonText)) {
    throw "No content in $inputFile"
}

# 示例变量（包含JSON特殊字符）
$var_1 = 'a "new" name'
$var_x = 'value with \ backslash'
$var_y = "first line`nsecond line"

# 正则匹配所有${var_name}格式的占位符
$variableRegex = '\$\{(\w+)\}'
$processedJson = [regex]::Replace($jsonText, $variableRegex, {
    param($match)
    $varName = $match.Groups[1].Value
    # 获取变量值（如果变量不存在会抛出错误）
    $varValue = Get-Variable -Name $varName -ValueOnly -ErrorAction Stop
    # 用ConvertTo-Json自动转义特殊字符，再移除前后的引号
    $escapedValue = (ConvertTo-Json $varValue -Compress) -replace '^"|"$', ''
    return $escapedValue
})

# 解析处理后的JSON
try {
    $jsonObj = ConvertFrom-Json $processedJson
    # 验证结果
    $jsonObj | ConvertTo-Json -Depth 10
}
catch {
    Write-Error "Failed to parse JSON: $_"
}

关键步骤解释 #

• 正则匹配：\$\{(\w+)\}精准匹配${var_name}格式的占位符，捕获变量名用于后续取值
• JSON转义：ConvertTo-Json会自动处理所有JSON特殊字符（双引号→\"、反斜杠→\\、换行→\n等），我们只需要移除它自动添加的前后引号即可
• 安全取值：Get-Variable确保只有已定义的变量会被替换，避免未定义变量导致的意外问题

为什么不用ExpandString？ #

ExpandString的设计目标是解析PowerShell风格的字符串插值，它会直接将变量值插入到字符串中，完全不关心插入后是否符合其他语法规范（比如JSON）。比如变量值中的双引号会直接破坏JSON的字符串边界，导致解析失败。

这种自定义替换的方式，既保留了模板变量的灵活性，又严格遵循了JSON的语法规则，能完美解决你的问题。

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