JSON 格式化与美化工具

什么是 JSON 格式化工具？

JSON 格式化工具（也叫 JSON 美化工具或 pretty-printer）会把 JSON 文本重新输出，每行一个值并统一缩进，让对象和数组的嵌套关系一目了然。数据本身不会改变：按照 RFC 8259 和 ECMA-404 的定义，JSON 中记号之间的空白没有意义。改变的是，你能多快在 API 响应、日志行或配置文件中找到想要的字段。

如何美化 JSON

1. 粘贴 JSON到输入编辑器，或把 .json 文件拖进去，也可以点击“打开文件”。
2. 选择缩进：2 个空格、4 个空格或制表符。勾选“键排序”可将每个对象的键按字母顺序排列。
3. 点击“格式化”（或按 Ctrl/⌘ + Enter）。格式化后的 JSON 会显示在右侧，可直接复制或下载。

示例

下面是某个 API 返回的压缩响应：

{"id":42,"user":{"name":"Ana","roles":["admin","dev"]},"active":true,"balance":12345678901234567890}

使用 2 个空格缩进后变为：

{
  "id": 42,
  "user": {
    "name": "Ana",
    "roles": [
      "admin",
      "dev"
    ]
  },
  "active": true,
  "balance": 12345678901234567890
}

注意最后一个值。如果格式化工具基于 JSON.parse 和 JSON.stringify，它会变成 12345678901234567000，因为 JavaScript 数字只能保存大约 15–17 位有效数字。ID、以最小单位计的账户余额以及区块链金额经常超出这个范围。这里会原封不动地保留数字文本。

JSON 无效时会怎样

格式化工具会边输入边校验。如果文本不是有效的 JSON，状态栏会变红，问题列表会显示每个错误的行号和列号；点击某一项即可跳转过去。常见问题包括最后一项后的尾随逗号、两个属性之间缺少逗号、单引号、键未加引号、注释以及括号不匹配。点击修复 JSON可一步完成自动修复并格式化结果；各类错误是如何检测的，请参阅 JSON 校验器页面。

格式化选项说明

• 缩进：每一层嵌套前插入的字符串，只影响可读性和文件大小。
• 键排序：按 Unicode 码点递归地对每个对象内的键排序。适合在提交生成的文件之前或进行 JSON 对比之前使用，让数据相同的两个文件能够对齐。
• 压缩：格式化的逆操作，删除所有可省略的空白；参见 JSON 压缩工具。
• 转为 YAML：把相同的数据转换为 YAML；参见 JSON 转 YAML。

JSON 格式化常见问题