JSON 是要缩进来看，还是摊平成表

两类需求分开处理：给人看、给系统校验，只缩进对齐；要进表格统计或对外交付，才摊平成行。动手前先把一句判断写死——「哪一层算一个记录」。规则不固定，同一份文件今天导三十行、明天导一百二十行，没人判断得了哪次对。

一、先判断走哪条路

二、摊平的操作顺序

1. 先看根节点是对象还是数组。根是数组，通常每个元素就是一行。
2. 找出所有数组路径。主列表里再套明细，就有两个候选层级。
3. 定主层级：报表关心谁的数量，谁就当行。
4. 一对多要么展开成多行并重复父级字段，要么合并成一格加分号，这一步先写在纸上。
5. 用 JSON 格式化 看清层级，再决定切在哪一层。
6. 要进表格的转到 CSV 转换 落成二维结构，旁边记一行摊平口径。

三、容易出错的地方

• 跳过定层级直接转：工具会自动挑一个它认为合适的数组展开，行数常常不是你要的。
• 深层嵌套硬拉平：四五层全展开会产生大量重复列，不如保留层级。
• 缺字段当成零：没有明细与明细为零是两件事，合并成一格要留可区分标记。
• 列顺序每轮都变：键序不稳定时，导出前显式固定列顺序。
• 中文值不看编码：落成文本文件后仍会遇到猜编码，Excel 与财务系统默认并不一致。

四、什么时候改用另一套思路

数据来自老系统对接、字段带大量属性时，源头多半是标记式文档。属性与一对多子节点会带来另一类漏抽风险，处理办法见 XML 转换。只要最终给非技术同事用，就同时交付一份字段含义说明。

常见问题

问：缩进会改变数据本身吗？
答：不会。空格与换行只是显示层；排查字段缺失时看某层的键名条数，与接口文档对不上再往下查。

问：手机上能做吗？
答：浏览器打开页面即可上传，缩进这类轻处理没问题；几十列的摊平结果小屏上核不动。

问：摊平会改动数值本身吗？
答：不会，缩进与摊平都只动显示层；改完比对一次字符总数更稳妥。

本站能力与限额说明

站内 JSON 格式化 (/doc-tools/json-format) 用于把结构化文本整理成易读层级或压缩回紧凑形式，并可按选定层级摊平成表；转换在服务器端完成，服务器装有可匹配的中文字体，特殊字体可能回退，涉密材料请自行评估是否上传。

不提供接口调用承诺与数据库同步，也不校验业务字段是否正确；加密文件需先解密，单次处理的数据量有上限，见工具页提示。

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