JSON 格式化看不懂?3 分钟学会校验与美化

调接口、写配置、看日志,程序员每天都要和 JSON 打交道。但从接口返回的 JSON 经常是一整行、几千个字符挤在一起,根本没法看;自己手写的 JSON 又动不动就报语法错误。

JSON 格式化工具就是干这件事的:把挤成一团的 JSON 展开成带缩进的漂亮格式,顺带校验语法、指出错误位置。本文讲清它的三种用法和常见报错。

三种用法:美化、压缩、校验

美化(Format):把单行 JSON 展开成带缩进的多行,方便阅读和排查问题,是最常用的功能。压缩(Minify):去掉所有空白字符压成一行,减小传输体积,适合放到代码或请求体里。校验(Validate):检查语法是否合法,不合法时指出错误位置。

一个典型工作流:从接口复制返回的 JSON → 粘贴美化查看结构 → 定位问题字段 → 修改后再压缩填回测试工具。

常见语法错误对照表

90% 的 JSON 报错逃不出这几种:行尾多了一个逗号(最常见);字符串用了单引号或中文引号;键名忘了加双引号;括号不配对(少了个 } 或 ]);写了注释(JSON 不支持注释);数字写成了 01 这种前导零形式。

排查技巧:看报错的行号列号,问题通常就在那个位置或它的上一行——比如「第 5 行报错」,很可能是第 4 行末尾多了个逗号。

  1. 把 JSON 文本粘贴到格式化工具的输入框。
  2. 点击「格式化」,合法 JSON 会立刻展开显示。
  3. 如果报错,看提示的行号列号定位问题并修正。
  4. 确认无误后用「压缩」得到单行版本,或用「复制」取走结果。
💡 不想看文字?直接动手试试
打开免费的「JSON 格式化校验」工具,本地处理、不用注册。
免费使用JSON 格式化校验 →

为什么不用记事本肉眼检查?

小段 JSON 肉眼还能应付,超过 100 行基本看不出问题。格式化工具的价值在于:一是瞬间排版,二是精确报错到行列号,三是高亮显示结构。对于嵌套五六层的复杂 JSON,这是唯一高效的办法。

另外提醒:粘贴包含密钥、token 的 JSON 到任何在线工具前,先确认工具是本地处理的。快工具箱的 JSON 格式化全程在浏览器里运行,文本不会上传,相对更放心。

常见问题

JSON 报错了怎么快速定位问题?
JSON.parse 的报错信息里通常带有出错位置(position),工具会把它换算成行号和列号。绝大多数错误集中在:多余的逗号、用了单引号、中文引号、漏了引号或括号。
为什么 JSON 里不能用单引号?
JSON 规范只允许双引号,这是设计之初就定死的规则。虽然 JavaScript 对象可以用单引号,但那不是合法的 JSON,接口传输时会被拒绝。
JSON 里能写注释吗?
可以。JSON 标准本身不支持注释,但校验工具通常会明确报错告诉你哪一行有注释,删掉即可。如果是配置文件场景,可以考虑换用 JSON5 或 YAML。
格式化会改变我的数据吗?
不会。格式化只改变排版(缩进、换行),压缩只去掉空白字符,数据本身一字不差。格式化后再压缩可以互相还原。

相关教程

相关工具