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 展开,至少有三个实际好处:
- 定位错误行号。格式化后解析器报的行号能直接对应到具体字段,排查速度快很多。
- 对比两次响应。把格式化后的结果放进文本对比工具,能清楚看到接口多了哪个字段、哪个值变了。
- 检查嵌套结构。层级缩进能暴露出「数组里套数组」「对象多包了一层」这类结构错误。
如果 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 打不开」的问题都能在两分钟内解决。