如何在JSON模板中完成字符串替换并正确处理特殊字符转义

解决方案 #

使用jq原生的变量注入机制就能完美解决你的需求，完全不需要手动处理转义，也不需要把模板嵌入通用编程语言中，和你标注的jq标签完全匹配。

• 你的JSON模板可以直接作为合法的jq过滤器使用，所有需要替换的变量保持$变量名的写法即可，不需要做任何额外修改，比如你给出的示例模板{ "x": $value }可以直接使用。
• 替换时通过jq的--arg参数传入字符串类型的变量值，jq会自动完成JSON规范要求的所有转义操作，包括双引号、换行符、转义字符等特殊字符的处理，不会出现JSON格式错误。
• 如果变量是数字、布尔值、数组、对象等非字符串类型，可以用--argjson参数传入，保证输出的JSON类型正确。

示例操作 #

比如要将$value替换为包含双引号的字符串测试"带引号"内容，执行命令：

jq -n --arg value '测试"带引号"内容' '{ "x": $value }'

最终输出的合法JSON如下：

{
  "x": "测试\"带引号\"内容"
}

如果模板复杂度较高，可以将模板单独保存为文件（比如template.jq），执行时通过-f参数指定模板文件即可，不需要修改任何模板内容：

jq -n --arg value '变量值' --arg otherVar '其他变量值' -f template.jq

该方案完全规避了手动字符串替换容易出现的转义遗漏、JSON格式损坏问题，所有JSON语法规范都由jq本身保证，稳定性极高。

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