JSON 转 CSV怎么用？完整使用教程与常见问题

JSON 转 CSV 是什么

JSON 转 CSV 是一种把层次化的 JSON 数据整理成二维表格的工具。JSON 常用于接口返回、配置文件和日志记录，结构灵活但不利于直接查看和统计；CSV 则是以逗号（或分号、制表符）分隔的纯文本表格格式，可以直接用 Excel、WPS 或数据库工具打开。这个工具的核心作用就是把 JSON 数组或对象中的字段提取出来，按列排列，遇到嵌套对象时自动扁平化，让每一层属性都能落到具体的表头下，生成结构规整、可直接导入表格软件或数据库的 CSV 文本。

JSON 转 CSV 怎么用

准备好要转换的 JSON 数据。工具通常对 JSON 数组的处理效果最好，例如 [{"id":1,"name":"A"},{"id":2,"name":"B"}] 这样的结构；如果是单个 JSON 对象，一般会被当作一行处理。
把 JSON 粘贴到输入框中，也可以直接拖入 .json 文件。数据粘贴完成后，工具会自动检测格式是否合法，若括号、引号不匹配会给出提示。
根据需要选择分隔符。逗号适合大多数 Excel 和数据库场景；分号适用于部分欧洲地区软件；制表符适合粘贴进表格或做批量文本处理。
确认是否开启嵌套对象扁平化。开启后，像 user: {name: "Tom"} 这样的结构会变成 user.name 这样的列名；如果字段是数组，通常会以索引或合并文本的形式展开。
执行转换并复制或下载结果。检查表头顺序和字段内容无误后，即可将 CSV 内容保存为 .csv 文件，或直接复制到 Excel 中。

常见使用场景

接口调试和数据处理是最典型的使用场景。开发或测试人员调用接口后得到一段 JSON 响应，里面往往包含多层结构，直接在编辑器里逐条查看效率很低。转成 CSV 后，可以按列排序、筛选、统计，快速确认数据条数和字段是否缺失。

运营和数据分析场景也很常见。从第三方平台导出或通过接口拉取的数据通常是 JSON 格式，例如订单列表、用户信息、埋点日志等。整理成 CSV 后，可以直接用 Excel 做透视表、计算转化率，或导入数据库进行后续关联分析。

把接口返回的订单、商品、用户数据整理成表格
将日志文件中的 JSON 记录批量转为可筛选的表格
把配置文件中的键值结构整理成对照表，便于比对版本差异
为数据库批量导入准备符合格式要求的数据文件

使用注意事项

转换前确认 JSON 本身是合法格式。多余逗号、单引号、注释等都会导致解析失败，建议先用格式化工具校验一遍。
数组和多层嵌套会被扁平化，列名可能变成 a.b.c 这类形式，转换后需要检查表头是否符合后续使用习惯。
批量数据中如果某些对象缺少字段，CSV 中对应单元格可能为空，导入数据库前要确认目标字段是否允许空值。
字段内容里如果包含分隔符、换行或引号，标准 CSV 会用引号包裹转义。若使用 Excel 打开出现串列，可尝试改用制表符或分号作为分隔符。

常见问题

JSON 数组和 JSON 对象都能转换吗？

都可以。数组是推荐形式，每个元素会对应 CSV 的一行，所有元素的字段名取并集作为表头。单个对象通常会转换成一行数据，如果对象内部还有多层嵌套，扁平化后可能只产生一列或几列，具体取决于结构深度。

嵌套很深的数据转换后表头太长怎么办？

扁平化后的列名一般由各级属性名用点号连接而成，层级越深列名越长。如果只需要其中某几个字段，可以在源数据中先删减无关属性，再执行转换；也可以转换后在表格软件里重命名表头，不影响数据内容。

转换后的中文出现乱码怎么处理？

多数情况下是编码问题。CSV 建议使用 UTF-8 编码保存，Excel 打开时如果显示乱码，可以先用记事本另存为带 BOM 的 UTF-8，或通过 Excel 的“数据—从文本/CSV”导入功能手动指定编码为 UTF-8。