· 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 就是按这种形状来的。

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

很深的树、递归子节点、每条记录结构都不同的文档,不适合整份摊成一张表。只抽出要进表格的那一层,或按实体拆成多个工作表。

JSON 转 Excel(可多表) →

反过来从 CSV 回到 JSON 时,值都会变成字符串,需要的话在代码里自己转型。

CSV 转 JSON →

相关工具

← 全部文章

更多文章