如何格式化和漂亮打印 JSON 数据

先了解输入与用途

JSON Beautifier 用于把 JSON 文本整理成带缩进的格式，方便阅读、检查层级和复制使用。它适合处理已经接近有效 JSON 的内容，不是用于修复语法错误的通用文本整理器。输出可以使用默认缩进，也可以按需要调整缩进设置；还可以选择是否对对象键进行排序。

格式化 JSON 的操作步骤

1. 将 JSON 文本粘贴到输入区域。输入可以是对象、数组或其他符合 JSON 语法的内容；如果输入框只包含空白，也会进入无输入分支，而不是生成格式化文本。

2. 设置缩进。未特别调整时，缩进设置默认为 2；如果希望层级更宽或更紧凑，可选择其他缩进设置。

3. 根据需要启用键排序。该选项默认关闭。启用后，对象键会按排序顺序排列，因此输出的键顺序可能不同于原始文本；不启用则不会因为这一选项主动重新排列键。

4. 执行格式化并查看结果。有效 JSON 会被解析为格式化文本，并标记为成功。格式化过程中，中文等非 ASCII 字符会保留为字符本身，不会被转义成编码形式。

如何理解结果

成功结果表示输入被识别为有效 JSON，并已按照当前缩进设置生成格式化文本。查看输出时，可以重点检查对象和数组的层级、缩进宽度，以及启用键排序后对象键的排列变化。

如果结果标记为不成功，输入通常没有通过 JSON 解码，不能把它当作已经格式化的内容使用；应先检查引号、逗号、括号和键名是否符合 JSON 语法。输入为空或只有空白时，结果会保持成功状态，但不会产生格式化内容，并附带无输入诊断，这与有效 JSON 的成功输出不同。

使用示例

你正在检查一段包含中文字段的配置数据，希望让层级更清楚并统一对象键的排列顺序。

将包含中文键名的有效 JSON 粘贴到输入区域，把缩进设置调整为 4，并启用对象键排序，然后执行格式化。

结果会标记为成功，并返回带缩进的格式化文本；启用键排序后，对象键会按排序顺序排列，中文字符保持为非转义字符。

使用限制

• 该功能不会把无效 JSON 修复成有效 JSON；输入必须先符合 JSON 语法，才能得到格式化文本。

常见错误

• 输入含有不符合 JSON 语法的内容时，操作会标记为不成功。请检查双引号、逗号、花括号和方括号的配对关系，确认输入有效后再执行格式化。

常见问题

可以调整 JSON 的缩进吗？

可以。缩进设置默认值为 2，也可以按需要调整；格式化结果会根据当前设置呈现层级。

能否按顺序排列对象键？

可以选择启用键排序；该选项默认关闭，启用后对象键会按排序顺序排列。

输入为空或 JSON 无效时会发生什么？

如果输入为空或只有空白，结果会保持成功但不产生格式化内容，并附带无输入诊断；如果输入不是有效 JSON，则会标记为不成功。