JSON 格式化完全指南
调用 REST API、写配置或联调时，JSON（JavaScript Object Notation）几乎总是默认格式。 下文说明语法要点、为何要格式化、常见写法错误，并链到即时工具上的免费在线工具。
什么是 JSON？
JSON 是轻量结构化文本：由对象、数组与标量组成。合法值仅限
对象、数组、字符串、数字、true、false、null。
键与字符串必须用双引号；成员之间逗号分隔但禁止尾逗号；字符串内用 \ 转义。
遵守这些规则，才能保证各语言标准库都能互解析。
JSON 格式化的作用
格式化（美化）即在合法 JSON 上加重缩进与换行；压缩则去掉空白以减小体积。
- 可读性：层级清晰，便于评审与写进文档。
- 调试：diff 对比、查缺字段或类型更直观。
- API 开发：示例响应与 Mock 常用美化展示；线上传输可改为一行省带宽。
常见 JSON 语法错误
- 键未加双引号：如
{name: "x"}无效。 - 单引号字符串：JSON 只接受双引号。
- 尾逗号：
[1,2,]、{"a":1,}会被拒绝。 - 注释：
//、/* */均非法。 - 非 JSON 类型：
undefined、NaN、原生 Date 等须先序列化为合法标量。
编辑器报错难懂时，把片段贴进在线校验工具，往往能看到更明确的行列提示。
在线 JSON 格式化工具推荐
即时工具 JSON 格式化 / 校验支持美化、压缩与语法检查，免注册，适合日常粘贴即用。
立即打开在线格式化工具
JSON 相关工具
- JSON 树形查看：展开深层结构。
- JSON Path：按表达式取节点，便于断言与迁移脚本。
- JSON ↔ CSV：与表格、报表互转。
常见问题（FAQ）
JSON 和 JavaScript 里的对象字面量是一回事吗？
不是。JSON 是严格的文本交换格式：键须双引号、无尾逗号与注释。JS 对象字面量更宽松，可有 undefined、函数等。
标准 JSON 允许写注释吗？
不允许（RFC 8259）。需要注释可用 JSON5、YAML，或构建时剥离注释再解析。
为什么解析时提示「Unexpected token」？
多为未用双引号、尾逗号、单引号、非法数值或非 UTF-8 编码。用格式化工具可较快定位行列。
大型 JSON 如何保持可读又节省体积？
开发用缩进美化，发布用一行压缩；仓库存可读版，CI 产出压缩版即可。
JSON 的价值是简单与互操作：严格语法是跨团队契约。养成格式化与校验习惯，并统一 UTF-8 与字段约定，联调更省心。