JSON 错误是最烦人的那种:文件看起来“没问题”,直到解析器报错。少一个逗号、多一个尾逗号、混入一行注释——配置文件就加载不起来了。
本站的 JSON 格式化工具在浏览器内完成格式化和校验,无需上传。
“格式化”到底做了什么
机器不在乎空白字符,所以接口和构建工具产出的 JSON 经常是压缩过的——整个对象挤在一行。格式化就是重新缩进,让结构一目了然:
{"name":"Ada","roles":["engineer","mentor"]}
变成:
{
"name": "Ada",
"roles": ["engineer", "mentor"]
}
数据本身没有任何变化——只是屏幕上呈现的形状变了。所以格式化对任何内容都是安全的,包括生产配置。
校验的部分
格式化的同时也在解析——问题 JSON 就是在这里现形的。工具能抓住这些经典错误:
- 尾逗号——
{"a": 1,}在 JavaScript 里合法,在 JSON 里非法。这一个错误弄坏的配置文件比所有其他原因加起来都多。 - 单引号——JSON 要求双引号。从 JavaScript 代码里复制粘贴是常见元凶。
- 注释——JSON 不支持注释。需要注释说明你编辑的是 JSON5 或 YAML 这类配置格式,而不是 JSON。
- 裸关键字——
true/false/null必须小写,True不是合法 JSON。
如果工具显示错误而不是输出结果,说明解析器定位到了确切的字符位置——通常几秒就能找到那个漏掉的逗号。
结构没问题但数据不对
格式化校验的是语法,不是含义。能解析的 JSON 仍然可能字段名写错、类型不对。涉及数据形状的工作,CSV ↔ JSON 转换工具可以帮你直观查看表格数据;而保持格式化输出,版本控制里的 diff 才能真正看懂。