搜索工具

↑ ↓ 选择Enter 打开Esc 关闭

JSON 格式化与校验:从报错到可读结构

六个最常见的 JSON 语法错误、格式化能解决的三个问题,以及处理大文件时的正确姿势。

JSON 是接口和配置文件里最常见的格式,但它对语法极其严格:多一个逗号、少一个引号,整个文件就会解析失败。很多人遇到「明明看起来没问题,却报 Unexpected token」的情况,问题往往出在几个固定的地方。

这篇文章整理了 JSON 校验的常见坑、格式化的实际用途,以及处理大文件时的思路。

一、六个最常见的 JSON 语法错误

1. 多余的尾逗号

JavaScript 对象允许最后一项后面带逗号,JSON 不允许。

{
  "name": "toolbench",
  "local": true,
}

上面这段在浏览器控制台里会直接报错。删掉 true 后面的逗号即可。

2. 用了单引号

JSON 的键和字符串必须使用双引号。从 Python 或 JavaScript 代码里复制出来的对象经常带单引号,需要整体替换。

3. 写了注释

JSON 标准不支持 // 或 /* */ 注释。如果配置需要注释,可以改用 JSON5、JSONC(VS Code 配置用的就是 JSONC),或者把说明写进一个 "_comment" 字段。

4. 字符串里有真实换行

JSON 字符串中不能出现未转义的换行符,必须写成 \n。从表格或多行文本粘贴内容时最容易出现这个问题。

5. 不可见的 BOM 头

Windows 记事本保存的 UTF-8 文件可能在开头带一个 BOM(EF BB BF)。解析器会把它当成非法字符。用编辑器的「以 UTF-8 无 BOM 保存」重新保存即可。

6. NaN、Infinity 和 undefined

这三个值在 JavaScript 里合法,但在 JSON 里不合法。序列化前要把它们转成 null 或字符串。

二、格式化不只是「变好看」

把压缩成一行的 JSON 展开,至少有三个实际好处:

  1. 定位错误行号。格式化后解析器报的行号能直接对应到具体字段,排查速度快很多。
  2. 对比两次响应。把格式化后的结果放进文本对比工具,能清楚看到接口多了哪个字段、哪个值变了。
  3. 检查嵌套结构。层级缩进能暴露出「数组里套数组」「对象多包了一层」这类结构错误。

如果 JSON 里键的顺序很乱,可以开启「键排序」,让相同结构的响应保持一致,方便做 diff。

三、校验通过之后,还要看语义

语法正确不代表数据正确。接口调试时值得额外确认:

  • 数字是不是被当成了字符串("price": "19.9" 和 "price": 19.9 在类型上不同);
  • 时间字段是时间戳还是 ISO 字符串,单位是秒还是毫秒;
  • 空数组 [] 和 null 在业务上是否等价;
  • 中文字符是否被转义成了 \uXXXX(能用,但阅读困难)。

四、处理几十 MB 的大 JSON

浏览器里的格式化工具适合几 MB 以内的文件。再大就会明显卡顿,甚至把标签页撑爆。这时候更合适的做法是命令行:

# 格式化并写入新文件
jq . big.json > big.pretty.json

# 只取需要的字段
jq '.data.items[] | {id, name}' big.json

# 校验语法
jq empty big.json && echo "valid"

如果只是想在浏览器里快速看一眼,建议先用 jq 截取前几百行,再粘贴到在线工具里。

五、粘贴之前先想一想

格式化工具会完整读取你粘贴的内容。如果 JSON 里包含数据库密码、支付密钥、用户手机号,把它粘贴到任何一个网站都存在泄露风险,尤其是那些需要把内容发送到服务器处理的工具。

判断方法很简单:打开浏览器开发者工具的 Network 面板,粘贴内容时如果出现新的请求,说明数据被上传了。本站的 JSON 格式化工具 使用浏览器内置的 JSON.parse 和 JSON.stringify 完成全部处理,不会发出任何包含你数据的请求。涉及敏感信息时,仍然建议优先在本地命令行处理。

小结

  • JSON 报错先查尾逗号、单引号、注释、换行、BOM 和特殊数值;
  • 格式化能帮你定位行号、对比响应、检查嵌套;
  • 大文件交给 jq,敏感数据不要离开本机。

把这几条记住,大部分「JSON 打不开」的问题都能在两分钟内解决。

继续阅读

全部文章