如何在 Python 中正确解析环境变量中的原始 JSON 字符串-Python教程-PHP中文网

当通过 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 的值为：

python-parallelization

将顺序 Python 代码转换为并行/并发实现，用于在需要并行化 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 字符串字面量。坚持这一实践，可避免所有因转义引发的解析异常。