首页 工具指南 JSON 格式化了还是看不懂?先认这五个位置
json

JSON 格式化了还是看不懂?先认这五个位置

拿到一坨没换行的 JSON,格式化只是第一步。这篇讲先看哪些位置能三秒判断结构、什么时候该压缩成一行,以及重复 key 到底取哪个。

2026 年 10 月 22 日 · 0 次阅读
本文配套工具:JSON 格式化/校验 直接用 →

接口返回来一段 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 格式化,不用注册,内容不上传。