当通过 jq 将 JSON 存入 Shell 环境变量时，若未使用 -r（raw output）标志，会导致字符串被双重转义，Python 的 json.loads() 无法直接解析；正确做法是在 jq 命令中添加 -r 标志输出未经转义的纯 JSON 字符串。
当通过 `jq` 将 json 存入 shell 环境变量时，若未使用 `-r`（raw output）标志，会导致字符串被双重转义，python 的 `json.loads()` 无法直接解析；正确做法是在 `jq` 命令中添加 `-r` 标志输出未经转义的纯 json 字符串。
在 Bash 中使用 jq 处理 JSON 并导出为环境变量时，一个常见误区是忽略 -r（raw string）选项。默认情况下，jq -s 或 jq -Rs 会将整个输入序列化为一个 JSON 字符串字面量 —— 即对引号、反斜杠等字符进行转义，并额外包裹一层双引号。例如：
echo '{"name":"Alice","age":30}' | jq -Rs
# 输出："{"name":"Alice","age":30}
"该结果作为环境变量值被 Python 读取后（如 os.environ["FOO"]），实际内容是带转义的字符串字面量，而非合法 JSON 文本，因此 json.loads() 会抛出 JSONDecodeError。
✅ 正确解法：始终为 jq 添加 -r 标志，确保输出为未转义、无额外引号包裹的纯 JSON 文本：
# ✅ 正确：-Rsr 组合（-R: read as raw string, -s: slurp, -r: output raw）
export FOO=$(curl -s "https://api.example.com/data" | jq -Rsr '.')
# 或更常见场景（已为 JSON 输入）：
export FOO=$(echo '{"status":"ok","data":[1,2,3]}' | jq -r '.')此时 FOO 的值为：
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
立即学习“Python免费学习笔记（深入）”；
{"status":"ok","data":[1,2,3]}——这正是标准 JSON 格式，可被 Python 安全解析：
import os
import json
try:
data = json.loads(os.environ["FOO"])
print(data) # {'status': 'ok', 'data': [1, 2, 3]}
except json.JSONDecodeError as e:
print(f"JSON 解析失败：{e}")⚠️ 注意事项：
- 避免使用 repr()、str.replace('\', '') 或 f-string 强制拼接等“手动去斜杠”方式 —— 这极易破坏合法 JSON 中的转义（如 {"message":"line break"} 中的 ），导致解析错误或安全风险；
- 若上游数据非 JSON 格式（如纯文本或 CSV），应先用 jq -R 读取为字符串，再结合 fromjson 或其他逻辑转换，而非依赖 -r 直接输出；
- 在 CI/CD 或容器环境中，建议对关键环境变量做预校验：
import json foo_str = os.environ.get("FOO", "") if foo_str.strip(): try: json.loads(foo_str) # 验证格式有效性 except json.JSONDecodeError: raise ValueError("环境变量 FOO 不是有效 JSON")
总结：问题根源不在 Python，而在 Shell 层 jq 的输出模式。-r 是解决该问题的标准、可靠且向后兼容的方式——它让 jq 输出真正符合 RFC 8259 的 JSON 文本，而非 JSON 字符串字面量。坚持这一实践，可避免所有因转义引发的解析异常。
