JSON 转 CSV：把 API 数据变成看得懂的表格

JSON 是为机器造的。嵌套对象、数组套数组、从没见过的键名。可一旦要给人看——客户、同事、周一早上的你自己——你要的是一张表格。

下面是坑在哪儿，以及怎么绕过去。

为什么顺手一转换就出错

大多数工具只把 JSON 压平一层就收工。嵌套对象变成 [object Object]，数组全塞进一个难看的单元格。文件能打开，但内容是垃圾。

解决办法：转换之前先想清楚，一行代表什么。

先定一行是什么：对象还是数组元素

两种形状几乎覆盖所有情况：

- 对象数组——最常见的 API 返回。每个对象一行，每个键一列。

- 单个对象——一行；或者转置，让键变成行。

如果键不一致（某条记录多了几个字段），大多数转换器会悄悄丢掉缺失的值。把它设成空，别靠猜。

要压平，但要有意识

像 `{"user": {"id": 7}}` 这样的嵌套对象，应该变成 `user.id` 和 `user.name` 两列。数组更麻烦：要么用分隔符拼进一个单元格，要么展开成多行。别让工具替你做决定。

一整个文件夹怎么办

一个 JSON 文件，复制粘贴就完事。每晚五十份日志导出，那是折磨。FileTools Batch Convert 一次收下整批，直接返回 CSV。

结论

搞清楚一行是什么，决定嵌套数据变成什么，编码守住 UTF-8。这样 JSON 就不可怕了。在浏览器里打开 FileTools 就能跑——什么都不离开你的电脑。