· CSV.ink Team
嵌套 JSON 怎么转成 CSV(字段别丢)
扁平的对象数组一步就能变成表。遇到嵌套对象和数组,要先定规则再导出,否则容易丢字段或写出 [object Object]。
JSON 喜欢嵌套,CSV 不喜欢。接口返回的客户带着 address 对象和 tags 数组时,随便转一版要么丢字段,要么格子里出现 [object Object]。导出前要先定摊平规则。
先从「结构差不多的对象列表」开始
CSV 是一张表:一行表头,后面每行列数相同。最省事的是 JSON 数组里每个元素都是键大致相同的对象:
[
{"id": 1, "name": "Ada", "city": "London"},
{"id": 2, "name": "Lin", "city": "Taipei"}
]这可以直接变成两行数据。我们的 JSON 转 CSV 就是按这种形状来的。
嵌套对象 → 带前缀的列
值本身还是对象时,把内部键抬升成列。address.city、address.zip 后面筛选比整格塞一段 JSON 好用。
{
"id": 1,
"name": "Ada",
"address": {"city": "London", "zip": "E1 6AN"}
}
→ id,name,address.city,address.zip
1,Ada,London,E1 6AN两个嵌套对象有同名键时,保留前缀,避免列名撞车。
数组 → 拼接、扩行或保留原文
列表塞不进一个干净单元格。整份文件选一种策略并坚持:
- 拼接:tags 写成 "a, b, c"。好看;标签里自己带逗号就麻烦。
- 扩行:列表每一项一行,父字段重复。适合分析;行数会变多。
- 丢掉,或整列保留原始 JSON,只给下一个程序读。
空值和类型
缺的键导出成空单元格,不要默认写成字符串 "null"(除非下游就认这个词)。编号、邮编若怕丢前导零,在 CSV 里当文本处理——Excel 一打开类型可能又变。
什么时候别硬转 CSV
很深的树、递归子节点、每条记录结构都不同的文档,不适合整份摊成一张表。只抽出要进表格的那一层,或按实体拆成多个工作表。
反过来从 CSV 回到 JSON 时,值都会变成字符串,需要的话在代码里自己转型。