JSON 格式化了还是看不懂?先认这五个位置
拿到一坨没换行的 JSON,格式化只是第一步。这篇讲先看哪些位置能三秒判断结构、什么时候该压缩成一行,以及重复 key 到底取哪个。
接口返回来一段 JSON,没有换行、没有缩进,眼睛根本没法扫。格式化之后就好看多了 —— 但「看得懂」和「看着整齐」是两件事。
下面是拿到一段陌生 JSON 时,最省时间的一套顺序。
01第一步:看最外层是对象还是数组
格式化后第一眼只看开头那个字符:
- 以
{开头 —— 一个对象,通常代表「一条记录」或「一个统一的响应壳」; - 以
[开头 —— 一个列表,里面通常是一批同结构的记录。
很多接口外面还套了一层壳,比如 { code, message, data },真正想要的东西在 data 里。先确认数据在哪一层,再往下看,能省掉一半找东西的时间。
02第二步:找第一个数组,那里通常是列表数据
在有缩进的视图里,数组会明显「宽出来」一块。定位到第一个数组,看它第一个元素有哪些字段 —— 同批数据的结构基本一致,看一条就够。
如果数组里嵌套了数组,说明是两层列表(比如订单里的商品)。这时候别急着展开全部,先折叠掉不关心的分支。
03第三步:留意重复 key
JSON 规范里没有规定重复 key 怎么办,各家解析器的行为并不统一:
- 大多数解析器(含浏览器
JSON.parse)取最后一个; - 个别库取第一个,还有的会直接报错;
- 严格的校验工具会把它标成错误。
所以看到重复 key,先当成数据有问题处理 —— 因为同一份数据在 A 系统读出来是 1、在 B 系统读出来是 2,这种 bug 极难查。格式化工具一般会提示重复 key,别忽略这个提示。
04第四步:大数字和精度
JSON 只有一种数字类型。9007199254740993 这种超过 253 的整数,用 JavaScript 解析会变成 9007199254740992 —— 订单号、雪花 ID 一类的长数字经常这样被悄悄改掉。
如果你在排查「为什么 ID 少了 1」,先怀疑这个。处理办法是让对方用字符串返回长 ID,而不是数字。
05第五步:转义字符
JSON 字符串里的中文、换行、引号常常是转义形态(\u4e2d 这种)。看着像乱码,其实是没解码的 Unicode。
处理转义有两个方向,别搞反:
- 去转义:把
\u4e2d还原成「中」,方便人读; - 转义:把中文压成
\u4e2d,方便塞进某些老系统或不支持中文的配置里。
06什么时候反而该压成一行
格式化是为了看,压缩是为了传。这些场合要压:
- 贴进 URL 参数、请求头、环境变量(换行会被截断或报错);
- 写进配置文件的一行字段;
- 塞进 Excel 单元格或数据库的单个文本字段。
压缩只去掉空白,不会改变数据结构 —— 但如果字段值里本来就有空格(比如地址),压缩前后要确认空格没被误删。
07需要的时候直接用
粘贴进去就能格式化、压缩、转义或去转义,还能一键提示重复 key 与语法错误位置。
打开JSON 格式化,不用注册,内容不上传。