JSON 格式化工具

步 1 / 4 JSON 格式化工具

JSON 输入

粘贴来自 API 响应、配置文件、webhook 或日志片段的 JSON，然后选择格式化、压缩或验证。格式化会用 2 或 4 个空格展开嵌套对象和数组，压缩会删除不必要的空白，验证会在复制结果前确认这段文本是否为有效 JSON。

如何格式化 JSON

1

粘贴 JSON

输入一个完整的 JSON 值：对象、数组、字符串、数字、布尔值或 `null`。
2

选择操作

选择格式化获得易读输出，选择压缩获得紧凑输出，或选择验证来检查语法。
3

选择缩进

格式化输出时，Web 项目通常用 2 个空格；如果仓库规范要求，也可以用 4 个空格。
4

复制结果

查看解析器消息或格式化后的输出，然后把结果复制回编辑器、API 客户端或文档。

这个 JSON 格式化工具能做什么

格式化 JSON：将 {"a":1,"b":[1,2,3]} 这样的紧凑输入转换为带缩进、易阅读的 JSON。
压缩 JSON：删除只用于提高可读性的空白，适合紧凑示例、嵌入内容和传输 payload。
验证语法：检查粘贴的文本能否按 JSON 解析。这是语法检查，不是 JSON Schema 验证。
处理任意 JSON 根值：对象和数组最常见，但 JSON 文本也可以是字符串、数字、true、false 或 null。
保持流程简单：粘贴，选择操作，查看输出，然后复制结果。

它有意不做的事

不会自动修复格式错误的 JSON。解析器消息会提示需要修正的位置。
不接受 callback({...}) 这类 JSONP 包装。
不接受 JSONC 中的注释或尾随逗号，除非你先将它们删除。
不会排序对象键。现有顺序会在解析器和序列化器允许的范围内尽量保留。
不验证业务规则、必填字段或 API schema。需要这一步时，请使用 JSON Schema 验证器。

格式化选择

场景	最合适的操作	为什么有帮助
阅读 API 响应	用 2 个空格格式化	嵌套对象和数组更容易浏览。
匹配仓库风格	用 2 或 4 个空格格式化	缩进一致能让代码审查更清晰。
将 payload 嵌入请求	压缩	删除空白而不改变 JSON 值。
检查从日志复制的数据	验证	复用前确认粘贴片段是完整 JSON。
准备 API 文档	格式化	示例更容易检查和复制。

可检测的 JSON 语法问题

解析器提示	常见原因	处理方式
`Unexpected token ' at position X`	键或字符串使用了单引号	JSON 字符串必须使用双引号。
`Unexpected end of JSON input`	缺少右花括号、右方括号或结束引号	检查粘贴文本的末尾。
`Unexpected token , at position X`	最后一项后有尾随逗号	删除尾随逗号。
`Unexpected token a at position X`	未加引号的键、`NaN` 或 `undefined`	给键加引号，并且只使用有效 JSON 值。
`Unexpected token / at position X`	从 JSONC 或 JavaScript 复制了注释	验证前删除 `//` 和 `/* */` 注释。

实用建议

审阅响应时先格式化，只有在确实需要紧凑 payload 时再压缩。
将 JSON 粘贴到文档、工单或 API 客户端之前先验证，尤其是来源只是部分日志行时。
保持项目已有的缩进规范。把现有文件从 2 个空格改成 4 个空格，可能会产生难以审阅的 diff。
避免把密钥、生产凭据或客户数据粘贴到通用 Web 工具中。处理敏感 payload 时，请使用组织批准的内部或离线格式化工具。

常见问题

不是。此工具只检查 JSON 语法。如果需要确认必填字段、允许值或对象结构，请在语法解析通过后再使用 JSON Schema 验证器。

严格 JSON 不允许注释或尾随逗号。验证或格式化前，请删除 JSONC 风格注释和最后的逗号。

使用项目已经采用的风格。JavaScript 和 Web 配置文件通常使用 2 个空格；某些后端仓库用 4 个空格会更易读。

请避免将密钥、访问令牌、凭据或客户记录粘贴到通用 Web 格式化工具中。处理敏感 payload 时，请使用已批准的内部或离线工具。

相关工具