工具说明
JSON 转 Excel 把对象数组写进真正的 XLSX 工作簿,而不是只改文件扩展名。每个数组元素成为一行,工具先用 `>` 连接对象路径和数组索引,把嵌套字段展开成稳定列名,再生成名为 Sheet1 的工作表。
预览最多展示前 20 行,但导出会处理全部数据。列集合取自所有行,某一行缺少的字段会保持空白;空对象和空数组会以 JSON 文本保存,避免完全丢掉它们的存在。
使用步骤
准备非空数组
根值应是 JSON 对象数组;单个对象先包进数组,JSONC 与 JSON5 写法也可以解析。
检查扁平化预览
确认 `customer>address>city` 这类路径列是否符合用途,并检查不同记录是否产生意外的新列。
生成并下载 XLSX
导出完整数据到 Sheet1,随后在目标表格软件里核对日期、长整数和换行。
支持范围与限制
- 输出
- XLSX 工作簿,一个 Sheet
- 输入要求
- 顶层为对象数组,每个元素对应一行
- 与 CSV 的区别
- XLSX 保留单元格类型,中文不会因编码问题乱码,也没有分隔符转义的坑
- 嵌套字段
- 会被平铺为列名,深层嵌套建议先用 JSON Flatten 处理再转
- 数字精度
- 超长整数在 Excel 中可能被显示成科学计数法或丢失末位,订单号建议以文本形式导出
- 公式
- 不生成公式,所有单元格都是静态值
典型使用场景
交付业务数据
把接口返回的订单或用户列表转成可筛选、可排序的工作簿交给运营同事。
保留嵌套路径
与直接 CSV 相比,路径列能保留对象与数组所在位置,之后还可用 Excel 转 JSON 还原。
生成可直接分发的报表附件
XLSX 保留单元格类型且不存在编码问题,比 CSV 更适合作为邮件附件发给业务方。
使用前需要知道的事
- Excel 会自动识别日期和科学计数法,订单号、手机号和超长整数可能需要在打开后设置为文本列。
- 嵌套数组按索引展开,数组长度差异很大时会产生大量稀疏列,不适合代替关系型数据表。
- 工作簿只创建一个 Sheet1,不会根据对象字段自动拆成多张表。
相关概念
- XLSX
- Office Open XML 工作簿格式,可以保存单元格类型、多个工作表和样式等结构。
- path column
- 用分隔符把嵌套路径编码成列名,例如 profile>skills>0。