发接口、读配置、调 API,天天跟 JSON 打交道。记住一句话:格式化是让人看清结构,压缩是给机器省体积,校验是按 RFC 8259 检查语法,三者都不改数据本身。下面把语法规则与三个操作的区别一次讲清。
JSON 的全称是 JavaScript Object Notation(JavaScript 对象表示法),一种轻量、与语言无关的数据交换格式,规范是 RFC 8259(2017 年发布,现行标准)与 ECMA-404。JSON 只有六种值:对象、数组、字符串、数字、布尔值(true/false)与 null;一个文档就是一个值。JSON 脱胎于 JavaScript 的对象字面量,但比 JavaScript 严格得多:很多在 JavaScript 里合法的写法,到了 JSON 里都是错的。
三个操作做的是三件不同的事:格式化只改排版,压缩只删空白,校验只检查语法,数据本身一个字符都不变。
| 操作 | 做什么 | 改数据吗 | 什么时候用 |
|---|---|---|---|
| 格式化 | 加换行与缩进,把结构展开 | 不改 | 自己读、调试、写文档时 |
| 压缩 | 去掉所有可有可无的空白 | 不改 | 发请求、存文件、要省体积时 |
| 校验 | 按 RFC 8259 检查语法对不对 | 不改 | 报错了、接手别人给的 JSON 时 |
格式化与压缩互为逆操作,互相转换不会丢内容;校验是前置步骤,先过了校验再谈格式化与压缩。三个操作都不改变数据的值,变的只是文本形态。
因为 JSON 的语法比 JavaScript 严格,对象字面量里常见的六种写法在 JSON 里全部非法:尾逗号、单引号、注释、NaN 与 Infinity、未加引号的键、前导 0 的数字。键名与字符串都必须用双引号:{name: "a"}在 JavaScript 里合法,在 JSON 里必须写成{"name": "a"}。尾逗号是最高频的错误:[1, 2,]在 JavaScript 里没问题,在 JSON 里直接报错。注释(//与/* */)根本不在 JSON 的语法里。NaN、Infinity 与 undefined 是 JavaScript 的值,不是 JSON 的值,替代办法是写 null 或带引号的字符串。数字也不能写前导 0(01非法,写1)或十六进制(0xFF非法,写255)。先把这六种写法清掉,大多数报错就消失了。
没有标准答案,2 格与 4 格都常见,选哪个取决于团队约定,而不是对错。2 格省行数,嵌套深了也不至于把内容顶到屏幕外;4 格层次更分明,适合嵌套浅、给人读的配置与文档。Tab 也行,但不同编辑器显示宽度不一样,混用容易乱。真正重要的是同一份文件、同一个项目里只用一种,固定下来就别再改。压缩则不用纠结:空白全删就是正确答案。记住一条分界:格式化给人看,选顺眼的;压缩给机器,选最小的。
MagiTool 的 JSON 格式化工具一次做完这三件事,全部在浏览器本地完成,数据不上传、不保存:格式化按 2 格或 4 格缩进展开结构,压缩一键去掉全部空白,校验实时指出语法错误的位置。
JSON 是按 RFC 8259 定义的数据格式,JavaScript 对象是编程语言里的数据结构。JSON 的语法更严格:键名与字符串必须加双引号,没有尾逗号、注释与 NaN、Infinity。只有符合 JSON 语法的那部分才能被 JSON.parse 读出来。
不会。格式化只加换行与缩进,压缩只删空白,两者都不动键、值与结构,解析出来是同一份数据。唯一变的是文本形态:一个给人读,一个给机器省体积。
能,只是人读着费劲。压缩只去掉空白,语法与数据完全保留,任何解析器都能正常读取。需要再看结构时,重新格式化一次就恢复原样,压缩是可逆的。
因为解析器报的是它第一次卡住的位置,不是错误的源头。最常见是少了一个逗号或括号,报错行往往在真正的错误之后几行。排查时从报错行往前找,先看括号是否配对、逗号有没有多一个或少一个。
标准 JSON 不能。RFC 8259 的语法里没有注释的位置,// 与 /* */ 都会导致校验失败。需要写说明时,改用 JSONC(带注释的 JSON 方言,仅编辑器与部分工具支持),或把说明写进键名、文档里,不要塞进 JSON 文本。
RFC 8259 要求键名应当唯一,但重复键名不算语法错误,校验能通过。问题出在解析时:大多数解析器只保留最后一个值,前面的会被静默覆盖,结果不可预期。写 JSON 时别让同一个对象里出现重复的键名。