这个工具用来做什么
JSON 是接口与配置文件最常见的格式,但它对语法要求很严格:多一个逗号、少一个引号、用了中文标点,整段数据就无法解析。这个工具做三件事——格式化把压成一行的 JSON 按两空格缩进展开,方便对照阅读;压缩去掉所有空白,得到适合放进请求参数或配置项的最小文本;校验只判断语法是否合法,不改动内容。
与在线格式化网站相比,这里的解析全部在浏览器里完成,输入不会离开本机。接口返回里有密钥、手机号、内部域名时,这一点比功能多少更重要。
怎么用
- 把 JSON 粘贴到左侧输入框,或点「示例」填入一段带嵌套与数组的样例。
- 点「格式化」得到缩进后的结果,右侧可滚动查看;点「压缩」则输出单行文本。
- 只想确认能不能解析,点「校验」即可,结果区不会变化。
- 点结果区右上角「复制」把处理后的内容写入剪贴板;「清空」会同时清除输入与结果。
- 输入过程中会自动做一次语法检查,状态条会实时提示错误,不必等点击按钮。
结果怎么解读
校验通过时,状态条显示「语法正确」,下方给出字符数、行数、实际字节数与顶层类型。字符数按 Unicode 字符计算,字节数按 UTF-8 编码计算,两者在含中文时差异明显——一个中文字符占 3 个字节,这决定了这段内容放进请求体后的真实大小。顶层类型会告诉你这段 JSON 是对象、数组还是单个值,接口返回通常应当是对象或数组。
校验失败时,状态条会给出原始错误信息、换算后的行列号,并在下方截取错误位置附近的三到五行,用 ^ 指向具体字符。行列号从 1 开始计数,与大多数编辑器的跳转行为一致;把光标移到对应行列,通常就能看到问题所在。
需要说明的是,浏览器给出的报错位置有时会指向错误的「下一个字符」。例如缺少右括号时,报错位置往往落在文件末尾而不是缺少的位置;多余逗号时,报错会指向逗号后紧跟的那个字符。因此定位到行之后,应当同时检查该行的前一个非空字符。
常见的几种错误
多余的逗号
对象的最后一个属性后面、数组的最后一个元素后面不能有逗号。这是从 JavaScript 对象字面量复制过来时最常见的问题,报错通常是 Unexpected token } 或 Expected double-quoted property name。
用了单引号或中文引号
JSON 只接受双引号。从文档或聊天记录里复制的内容,引号可能被自动替换成 “ ” 或 ‘ ’,肉眼几乎看不出差别,但解析一定失败。报错位置通常就在第一个中文字符附近。
注释与尾随内容
标准 JSON 不支持 // 与 /* */ 注释。此外,一个文件里只能有一个顶层值,前后拼接两段 JSON 会报 Unexpected non-whitespace character after JSON。
不可见字符与 BOM
从 Excel 或某些后台导出的文本开头可能带 BOM,粘贴后表现为第一个字符无法识别。此时把内容全部选中再粘贴一次,或手动删掉开头一个字符即可。换行符差异一般不影响解析,但会让行列号与你本地编辑器差一行。
数字格式与特殊值
JSON 不支持 NaN、Infinity、十六进制数字与前导零。以字符串保存的数字没问题,但如果接口里出现了 NaN,需要先在服务端处理成 null。
jq)处理,避免浏览器卡顿。