如何格式化并校验 JSON

如何格式化并校验 JSON

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 才能真正看懂。