判断标准只有一句:能变成表的 JSON 里必然有一个可重复数组,数组里每个对象就是一行,对象的每个键就是一列。选错数组,或者一边取外层字段一边取内层字段,行数就会成倍增减。

一、五步落地

  1. 格式化:先用 JSON 格式化 展开缩进,压平的内容无法判断层级归属。
  2. 找数组:从外往里数,记下每层数组的位置和大概元素数。通常最深那个才是明细,外面的是分组。
  3. 定行粒度:明确一行代表一条订单,还是代表订单里的一件商品。这个决定要和看表的人确认一次。
  4. 抽字段:只保留需要的键,其余整段丢掉。嵌套对象要么展平成父字段加子字段,要么只取里面某个值,不要整个塞进一格。
  5. 出表:拼成 CSV 后用 CSV 转换 输出为表格文件。

二、行数为什么会不对

现象原因处理
行数翻倍同一条记录在两个数组里都被取到只保留一个主数组驱动行
行数减半部分对象缺某个键被当无效行跳过缺键填空值而不是丢行
某列整体为空该字段在外层对象上不在行对象里把外层字段复制到每一行
列数不一致不同对象含的键不一样以全部键的并集作表头

三、表头与列名怎么定

键不一致最常见:新接口常有增量字段而早期记录没有,所以表头必须用并集。给非技术同事看时,表头换成中文业务名,映射关系另存一张小表随附,时间戳统一成日期时间样式、金额单独一列。

四、别做这几件事

  • 不要手工补齐缺失的行:先回去确认是真没有还是解析漏了,补出来的假数据最难查。
  • 不要在同一张表里混两种粒度:一半行是订单一半行是商品,后续求和必然重复计算。
  • 不要假设每次响应字段相同:接口改版不会通知你,定期重跑一遍键并集检查。

常见问题

问:能不能直接把 JSON 丢进去就得到 Excel?
答:不能一步到位。行粒度和列清单属于人的判断,本站能做的是格式展开与 CSV 同表格文件之间的互转。

问:多层嵌套怎么摊平?
答:约定分隔符把路径连起来当列名。嵌套数组是否炸开成多行会改变行数,必须显式确认。

问:手机上能做吗?
答:格式化和转换可以在手机浏览器完成,定列结构与排版建议在电脑上做。

本站能力与限额说明

站内 JSON 格式化(/doc-tools/json-format)负责把响应展开成清晰层级以便确认取哪一层,随后用 CSV 转换输出成表格文件;转换在服务器端完成,服务器装有可匹配的中文字体,特殊字体可能回退,涉密材料请自行评估是否上传。

本站不提供接口调用、不做自动字段映射,也不提供对外 API 服务承诺;非法语法的输入需要先自行修正。

游客与未充值注册用户单文件上限 8MB、每天 5 次成功转换;充值 VIP 会员后单文件上限提高到 20~50MB(随档位递增),转换次数不限,各档当前售价与额度以 会员页 为准。文件处理完保留 24 小时,到期自动清理,成品请当天下载。