如何将 JSON 转换为 CSV

先了解输入和输出

JSON 转 CSV 工具适合把结构清晰的 JSON 文本整理成 CSV 文本，便于在表格或其他支持 CSV 的场景中继续处理。输入可以是一个对象，也可以是以对象开头的非空数组。工具会根据已处理记录中的字段生成表头，并按照字段出现的先后保留不同字段的顺序。

转换 JSON 的操作步骤

准备 JSON 文本。不要留空或只输入空白字符；内容必须是格式正确的 JSON。单个对象会作为一条记录处理。若使用数组，数组不能为空，第一项必须是对象；其他顶层值不符合初始处理条件。
将 JSON 文本输入转换工具。输入内容应保持完整，特别注意双引号、逗号、括号和数组结构。格式错误的 JSON 会被拒绝，不会生成转换结果。
需要时设置分隔符。不填写时使用逗号。如果提供的分隔符包含多个字符，工具只取其中第一个字符；提供空值时仍回退为逗号。因此，若希望使用分号或制表符，应直接提供对应的单个字符。
执行转换并查看生成的 CSV 文本。表头会收集已处理记录中出现的字段名，首次出现的字段优先排列。某条记录缺少表头中的字段时，该位置写入空字符串；记录中的值会先转换为文本后写入。表头之后，每条已处理记录对应一行 CSV。
如果使用数组，先检查后续项目也都是对象。数组第一项通过检查，并不代表后续项目会再次进行同样的对象验证；后续出现数字、空值或数组时，处理可能在转换过程中失败。

如何阅读转换结果

结果中的第一行是字段名组成的表头，后续行对应已处理的记录。字段在不同记录中出现时，会合并到同一张表头中，并按首次发现的顺序排列。某行没有对应字段时，看到空单元格是预期表现；数字、布尔值等会以文本形式写入。

顶层对象通常只产生一条记录，因此结果会包含表头和一条数据行。顶层数组则按记录数量写出数据行，但前提是数组非空且第一项为对象，同时后续项目也能在处理过程中按对象使用。空数组、第一项不是对象的数组，以及其他顶层 JSON 值不会通过初始校验。嵌套对象或数组的具体展开方式不属于已确认的转换范围，不应预期它们自动拆成多个 CSV 列。

使用示例

你有一条包含姓名和年龄的 JSON 记录：{"name":"Li Ming","age":30}，希望得到可按字段读取的 CSV 文本。

在工具中输入该对象并使用默认分隔符执行转换。

结果包含一行表头和一行数据行：表头包含 name、age，数据行对应这两个字段的文本值。

使用限制

空数组、第一项不是对象的数组和其他顶层非对象值不通过初始校验；后续数组项目未独立验证，嵌套对象或数组也不应预期自动展开成多个 CSV 列。

常见错误

原因：JSON 语法错误，或数组为空、第一项不是对象，或后续项目不是可按对象处理的记录。纠正：先验证 JSON 结构，再确认数组非空、第一项为对象，并检查后续项目的类型。

常见问题

可以把 JSON 数组转换为 CSV 吗？

可以，但数组必须非空且第一项必须是对象。后续项目若不是可按对象处理的记录，转换可能失败。

如何更改 CSV 的分隔符？

可以。未提供分隔符时使用逗号；多字符分隔符只保留第一个字符，空值则回退为逗号。

如果某条 JSON 记录缺少字段，会显示什么？

会。缺少该字段的记录在对应 CSV 位置写入空字符串；字段名按各记录首次出现的顺序组成表头。