工具介绍
API 和数据库返回的数据通常是 JSON,但表格软件、Excel、Google Sheets 和大多数数据导入工具要的是 CSV。这个工具补上这个缺口:粘贴一个 JSON 对象数组(比如一段 API 返回),它会为每个不重复的键生成一列,每个对象生成一行。
转换过程处理了容易被忽略的细节:包含逗号或引号的值会被正确转义,缺失的字段会变成空单元格而不是报错崩溃,字段里嵌套的对象或数组会被序列化成该单元格里的 JSON 文本,而不是被静默丢弃。
为什么使用它?
- 自动表头识别——列名是所有对象键的并集,字段不一致的记录也不会破坏输出结果。
- 正确的 CSV 转义——含逗号、引号或换行的值会被正确加引号,能在 Excel、Google Sheets 里干净打开。
- 支持嵌套数据——字段里的对象或数组会被序列化成 JSON 文本,而不是报错。
- 可直接复制到剪贴板,或下载为 .csv 文件。
- 100% 本地运行——你的数据(API 返回、导出记录)不会被上传到任何地方。
使用方法
- 粘贴一个 JSON 对象数组,例如 [{"name":"Alice","age":30},{"name":"Bob","age":25}]。
- 点击"转换为 CSV"。
- 查看输出结果——复制它,或点"下载 CSV"保存文件。
- 用 Excel、Google Sheets 或任意表格软件打开下载的文件。
示例
输入
[{"name":"Alice","age":30},{"name":"Bob","city":"NYC"}]输出
name,age,city
Alice,30,
Bob,,NYC注意"city"和"age"都成了列,即使没有一个对象同时拥有这两个字段——缺失值直接留空。
实用建议
- 把 API 返回转换成表格报表:直接从浏览器的网络请求面板或 API 测试工具里粘贴 JSON 数组,转换、下载,不需要写脚本。
- 处理字段不一致的记录(比如表单导出里的可选字段):自动表头识别意味着你不需要先手动统一数据结构。
- 如果你的 JSON 是一个大对象、里面嵌套着数组(比如 {"users": [...]}),先提取出那个数组部分([...] 那一段)再粘贴进来。
为什么列顺序和完整性很重要
一个不起眼但很常见的 CSV bug 是:先写好表头再指望每一行都对得上——如果1000行里第50行多了一个前面所有行都没有的字段,简易的逐行CSV写入逻辑要么悄悄丢掉这个字段,要么让后面所有列都错位。本工具规避了这个问题:先扫描数组里的每一个对象,构建出完整正确的表头行,然后才开始写第一行输出——所以哪怕某个字段只在最后一个对象里出现过一次,它依然会拿到自己的列,其他行对应位置正确显示为空,而不是破坏整行的结构。
常见问题
能处理单个 JSON 对象而不是数组吗?
本工具需要数组格式——把单个对象用方括号包起来即可,比如把 {"name":"Alice"} 改成 [{"name":"Alice"}],就会转换成一行的 CSV。
字段里嵌套的对象或数组会怎么处理?
会被序列化成该单元格里的 JSON 字符串(比如某字段内容是 {"a":1},在 CSV 里就变成正确转义的文本 "{""a"":1}"),而不是报错或被丢弃。如果需要把嵌套数据拆分成独立的列,那需要针对具体数据结构的专用工具。
我的数据会被上传到服务器吗?
不会。转换完全通过浏览器 JavaScript 本地完成,不会发送到任何地方,可以放心用于导出的客户或业务数据。
为什么我的 CSV 里有空单元格?
如果数组里有些对象缺少其他对象拥有的某个键,这一列依然会存在,但没有该字段的对象对应单元格留空——这是为了保留所有数据,而不是因为记录不一致就报错。
值里带逗号会不会破坏 CSV 格式?
不会。任何包含逗号、引号或换行的值都会按标准 CSV 规则自动加上引号(内部引号会转义),能在 Excel 和 Google Sheets 里正确打开。