JSON 转 CSV

JSON 转 CSV 是什么

JSON 转 CSV 是把结构化 JSON 数据转换成适合表格查看和处理的 CSV 文件。本工具适合将 API 返回数据、配置导出数据或 JSON 数组整理成表格，并支持在转换前选择数据来源、字段和嵌套数据的处理方式。

JSON 转 CSV 支持哪些数据结构

最常见的输入是由多个对象组成的 JSON 数组，例如 [{\"name\":\"Tom\",\"age\":18},{\"name\":\"Jack\",\"age\":20}]。工具会将每个对象转换为一行，并把对象字段转换为 CSV 列。

如果 JSON 外层是一个对象，也可以根据数据结构选择顶层数据，或者使用 JSONPath 指定实际需要转换的数组，例如 $.data.list。这样可以直接从 API 常见的 {\"data\":{\"list\":[...]}} 结构中提取列表。

三种数据来源方式

自动识别会根据输入 JSON 的结构选择适合的数据源；顶层数据用于直接转换 JSON 顶层的对象或数组；JSONPath 则可以手动指定要转换的数据位置，例如 $.data.list。当一个 JSON 文件包含多个字段而真正需要导出的是其中某个数组时，JSONPath 方式更加直接。

如何处理 JSON 字段

字段可以使用自动模式或完整字段模式。自动模式根据实际数据生成适合 CSV 的列；完整字段模式用于保留转换范围内出现的字段。不同对象的字段不完全相同时，字段处理方式会影响最终 CSV 的表头和空值位置。

嵌套对象如何转换成 CSV

JSON 中的嵌套对象不能直接作为普通表格列，因此工具提供两种处理方式。保留为 JSON 时，嵌套对象会作为一个 JSON 值写入单元格；展开为列时，会把嵌套字段展开成独立列，更适合后续在电子表格或数据分析工具中处理。

例如 {\"user\":{\"name\":\"Tom\",\"age\":18}} 中的 user 对象可以保留为一个 JSON 单元格，也可以展开成类似 user.name、user.age 的字段。

数组如何转换成 CSV

数组可以保留为 JSON 字符串写入单元格，也可以按行展开。保留为 JSON 适合保持原始结构；按行展开适合数组本身代表一组需要逐条处理的数据。选择哪种方式取决于后续是希望保留 JSON 结构，还是希望直接在表格中逐行查看数组元素。

如何把本地 JSON 文件转换成 CSV

切换到文件上传页签后，可以将 .json 文件拖入页面，或者点击选择文件。文件会直接在浏览器本地读取，单文件上限为 10 MB。文件载入后可以继续选择数据来源、字段、嵌套对象和数组的处理方式，再执行转换。

JSON 转 CSV 后怎么使用

转换完成后，页面会显示 CSV 预览和完整文本结果，可以直接复制，也可以下载 CSV 文件。生成的 CSV 适合继续使用 Excel、表格软件、数据库导入工具或其他数据处理程序打开和处理。

JSON 转 CSV 常见问题

如果转换结果为空，先确认 JSON 本身有效，并检查数据来源是否指向实际包含记录的数组。如果 JSON 数据位于嵌套对象中，可以尝试使用 JSONPath，例如 $.data.list。如果生成的列不符合预期，再检查嵌套对象和数组的处理方式，以及输入对象之间的字段是否一致。

本工具的处理方式

JSON 解析、字段整理、嵌套数据处理和 CSV 生成均在浏览器本地完成，输入内容不会上传服务器。适合处理不希望发送到第三方服务的 API 数据、配置文件和本地 JSON 文件。