将嵌套 JSON 数据精准转换为 CSV 格式（含自定义列头）-Python教程-PHP中文网

将嵌套 JSON 数据精准转换为 CSV 格式（含自定义列头）

本文详解如何使用 jq 工具高效提取 json 中指定字段（如 .columns[].id 作为 csv 表头、.rows[].values 作为数据行），生成标准 csv 输出，并提供可直接运行的命令、注意事项及 python 备选方案。

本文详解如何使用 jq 工具高效提取 json 中指定字段（如 .columns[].id 作为 csv 表头、.rows[].values 作为数据行），生成标准 csv 输出，并提供可直接运行的命令、注意事项及 python 备选方案。

在处理结构化 API 响应或配置导出数据时，常需将嵌套 JSON 转换为扁平化的 CSV 文件，尤其当表头需动态取自某子数组（如 "Columns"）、而数据行来自另一平行结构（如 "Rows"）时。手动解析易错且不可复现，而 jq 作为轻量级流式 JSON 处理器，是此类任务的理想选择。

✅ 推荐方案：单行 jq 命令完成转换

针对您提供的 JSON 示例（含 Columns 定义表头、Rows.Values 提供数据），以下 jq 命令可一步生成合规 CSV：

jq -r '[.Columns[].Id], (.Rows[].Values) | @csv' input.json

输出结果：

"ItemName","Date","Qty"
"ITEM1","10-MAY-2024","100"
"ITEM2","20-MAY-2024","200"
"ITEM3","30-MAY-2024","400"

? 命令解析：

[.Columns[].Id]：提取所有列 ID 构成数组 ["ItemName", "Date", "Qty"]，作为首行（表头）；
(.Rows[].Values)：逐个展开 Rows 中每个对象的 Values 数组（即 ["ITEM1", "10-MAY-2024", "100"] 等）；
| @csv：将输入的每一行数组（表头 + 每条数据行）自动转为 RFC 4180 兼容的 CSV 字符串（自动加引号、转义特殊字符）；
-r 参数：输出原始字符串（raw output），避免 JSON 双引号包裹。

? 提示：若需调整大小写（如 ITEM1 → Item1），可在 Values 后链式处理，例如：
(.Rows[].Values | map(ascii_downcase))；但注意此例中原始值为全大写，通常应保留原始格式以确保数据一致性。

⚠️ 注意事项与常见陷阱

严格匹配路径：确保 JSON 结构与 jq 路径一致。若 Columns 或 Rows 缺失，命令会输出空行或报错。建议添加防御性检查：
```
jq -r 'if has("Columns") and has("Rows") then [.Columns[].Id], (.Rows[].Values) | @csv else empty end' input.json
```
空值/缺失字段处理：@csv 默认将 null 转为空字符串 ""。若需显式 "NULL"，可用 // "NULL" 替换：
(.Rows[].Values | map(. // "NULL"))
性能考量：对超大 JSON（GB 级），jq 内存加载可能受限。此时推荐分块处理或切换至 Python 的 ijson 流式解析。

? Python 备选方案（适用于复杂逻辑或环境限制）

当需额外数据清洗、类型转换或集成到脚本中时，Python 提供更灵活控制：

import json
import csv
import sys

def json_to_csv(json_path, csv_path):
    with open(json_path, encoding='utf-8') as f:
        data = json.load(f)

    # 提取表头与数据行
    headers = [col['Id'] for col in data.get('Columns', [])]
    rows = [row['Values'] for row in data.get('Rows', [])]

    # 写入 CSV
    with open(csv_path, 'w', newline='', encoding='utf-8') as f:
        writer = csv.writer(f, quoting=csv.QUOTE_MINIMAL)
        writer.writerow(headers)
        writer.writerows(rows)

# 使用示例
json_to_csv('input.json', 'output.csv')

该脚本兼容 Python 3.6+，自动处理中文、逗号、换行符等 CSV 特殊字符（quoting=csv.QUOTE_MINIMAL），且易于扩展字段映射、空值填充、编码转换等功能。