JSON 格式化怎么做?在线工具操作步骤与常见报错处理

JSON 格式化的核心操作只有三步：把 JSON 文本粘贴进在线工具的输入框，工具自动或点击按钮完成语法解析，然后在输出区得到带缩进的易读结构。如果文本本身不合法，格式化会失败并报错，所以格式化过程同时也是一次语法验证。JSON.cn 这类在线工具适合处理临时、零散的 JSON 文本，不需要安装任何软件；涉及敏感数据的 JSON 不建议粘贴到公共在线工具中。

格式化与压缩的区别

两者是对同一份 JSON 的相反操作，用途完全不同：

操作	效果	典型用途
格式化	增加换行和缩进，展开嵌套结构	阅读、调试、排查字段
压缩	去掉所有非必要空白，压成一行	减小传输体积、嵌入配置

格式化后的 JSON 和压缩后的 JSON 在语义上完全等价，解析结果一致，区别只在可读性。调试接口返回数据时用格式化，把 JSON 写进请求体或配置文件时用压缩。

在线格式化的具体步骤

准备文本：从接口响应、日志、配置文件里复制完整的 JSON 内容，注意不要漏掉开头和结尾的括号。
粘贴到输入区：把文本放进工具的输入框。如果原文是压缩成一行的，粘贴后通常仍是一行。
触发格式化：多数工具会在输入后自动解析并输出缩进结果，也有工具需要点击“格式化”按钮。
检查输出：确认输出区的结构层次清晰，每个键值对独立成行。
取用结果：复制格式化后的文本，或使用下载功能保存为文件。

预期结果是输出区出现逐层缩进的 JSON，嵌套的对象和数组通过缩进体现层级关系。

格式化前先做语法验证

格式化失败几乎都是因为 JSON 不合法。JSON 的语法比 JavaScript 对象字面量更严格，常见错误集中在以下几类：

多余的尾逗号：{"a": 1, "b": 2,} 中最后一个逗号不合法，删掉即可。
键没有加双引号：{name: "x"} 不合法，键必须是双引号包裹的字符串，应写成 {"name": "x"}。
用了单引号：JSON 只接受双引号，{'a': 1} 需要改成 {"a": 1}。
括号不匹配：缺少或多出 { } [ ]，工具通常会提示出错位置。
值类型写错：undefined、NaN、函数、注释都不是合法 JSON 值。
不可见字符：从网页或文档复制时可能带入全角引号、不间断空格等，肉眼难辨但会导致解析失败。

排查方法是根据工具提示的行号或字符位置定位，逐段删除可疑内容再重新格式化，直到通过。

中文乱码与转义字符

JSON 中的中文有两种存在形式：直接写中文，或写成 \uXXXX 转义序列。两者都是合法 JSON，格式化工具一般都能正确显示。

如果格式化后中文显示为乱码，通常是源文本的编码不是 UTF-8，或复制过程中编码被破坏。处理方式是确认原始数据的编码，必要时先转成 UTF-8 再粘贴。

转义字符方面，JSON 字符串内的双引号、反斜杠、换行等需要用 \"、\\、\n 表示。格式化不会改变这些转义的含义，只是让结构更易读。如果一段 JSON 被整体转义成了字符串（例如嵌在另一个 JSON 的字段里），需要先做反转义，再格式化。

超大 JSON 的注意事项

在线工具依赖浏览器处理文本，JSON 体积过大时可能出现卡顿甚至无响应。遇到这种情况：

优先在本地用编辑器或命令行工具格式化，避免把大文件传进浏览器。
如果必须用在线工具，先确认文件大小是否在工具可承受范围内。
超大 JSON 往往嵌套很深，格式化后行数极多，建议配合编辑器的折叠功能阅读。

格式化之后的后续操作

格式化只是第一步，得到可读结构后常接着做这些事：

复制或下载：把结果用于文档、代码或存档。
转成其他格式：例如 JSON 转 XML，或把 JSON 转成实体类代码，方便在项目中直接使用。
反向压缩：确认结构无误后，再压缩回一行用于传输或存储。

JSON.cn 提供了解析、验证、格式化、压缩以及 JSON 与 XML 相互转换等功能，可以在同一个工具里完成这一串操作，减少在多个页面之间切换。