接口返回一整行 JSON 时,先别急着“排好看”:先确认语法有效,再查字段和类型,最后才选格式化、压缩或导出。可以从JSON 格式化与在线解析开始;拿到的是 XML、YAML 或样式表,就换对应工具。缩进整齐不代表订单金额正确,也不等于通过业务系统的校验。
本文依据 2026 年 11 月 18 日(Asia/Shanghai)查阅的 JSON 工作台公开说明及相关工具页编写。下文的内置示例有浏览器工作记录及中英文原始截图支持;其他能力仍明确区分为页面说明,不冒充逐项实测。
先分清:阅读、压缩,还是找字段
| 手头的问题 | 选哪个工具或操作 | 还要核对什么 |
|---|---|---|
| 接口响应挤成一行 | JSON 的“格式化” | 字段类型、嵌套内容、数字原文 |
| 需要紧凑 JSON | JSON 的“压缩” | 不是删字段或改字符串里的空格 |
| 找深层字段 | 结构树、JSON Pointer | 路径是否指向想找的值 |
| 看 Sitemap、RSS 等 XML | XML 格式化 | 格式良好不等于符合 XSD |
| 整理配置文件 | YAML 格式化 | 应用自己的配置规则另查 |
| 阅读 CSS、SCSS、Less | CSS 格式化 | 页面样式另做浏览器测试 |
| 准备精简的 CSS 交付文件 | CSS 压缩 | 覆盖顺序和实际显示是否正常 |
先备份原文。要查看 JSON 树、对比或导出 CSV,用专门的 JSON 工作台;多语言代码格式化是另一套共用界面,适合切换语言整理代码。自动识别可能误判短片段,必要时手动选语言。也不是每种语言都有压缩:该页引擎表没有提供 YAML 压缩。
严格 JSON:不要把 JavaScript 对象直接贴进去
实际演示的操作是“载入示例”,确认替换内容,再点“格式化”。中英文页面提供的输入相同:
{
"orderId": 9123372036854000123,
"currency": "USD",
"products": [
{ "sku": "FAN-001", "name": "EC fan", "price": 129.00, "quantity": 2 },
{ "sku": "FAN-002", "name": "AC fan", "price": 89.50, "quantity": 1 }
],
"shipping": { "country": "US", "postalCode": "00123" },
"notes": "=This text stays text in safe CSV"
}
工作记录中的状态为“严格 JSON 有效 · 未发现重复键”,右侧为“右侧严格 JSON 有效 · 数字原文保留”。右侧把商品对象展开成多行,9123372036854000123、129.00、89.50 仍保留原写法。输入状态显示 334 字节、18 个值、3 层嵌套;记录的格式化结果为 400 字节。格式化是增加可读性,不是让文件更小。需要紧凑版本时才选择“压缩”,字段定位则可从结构树继续检查。
RFC 8259规定键名、字符串使用双引号;注释、单引号、尾随逗号、NaN、Infinity、十六进制数字都不属于严格 JSON。例如 {"sku":"00042",} 的问题是末尾多了逗号,增加缩进并不能修好它。JSON 根值也不必一定是对象,数组、字符串、数字、布尔值和 null 都可以。
重复键要单独说明:RFC 8259 建议同一对象的键名唯一,不同解析器处理重复键的方式可能不同。迅龙页面说明采取更严格的策略:同一对象内重复键视为错误,定位第二次出现的位置。两个商品对象各有一个 sku 则正常。语法通过也不代表必填字段齐全,或符合接口业务规则。另一次英文页严格校验测试中,输入 {"a":1,} 后提示 “Strict JSON does not allow trailing commas.”,位置为第 1 行第 8 列,未生成格式化结果;这里不编造对应的中文报错原文。

找字段:JSON Pointer 不是 JSONPath
页面说明支持从结构树选择字段、定位原文、复制 JSON Pointer。以上面内置示例为例,/products/0/sku 表示 products 数组第一个对象的 sku,数组从 0 编号。这是依据 RFC 6901解释路径,不是界面点击结果记录。
键名里本来就有 / 时,在路径里写成 ~1;本来有 ~,写成 ~0。这不是 URL 的百分号编码。该字段也不支持 JSONPath 的通配符和筛选表达式。给同事定位问题时,发具体路径比“底下那个 SKU”更准确。
大整数与前导零:别只检查缩进
JSON 页面说明使用 lossless-json 保留数字原文,列出的例子包括 9123372036854000123、2.370、2.3e500。本次格式化记录已核对示例长订单号与小数写法,但没有验证所有数值或所有导出路径。即使当前工具保留原文,下游程序仍可能把长整数舍入,或把小数写法规范化。
示例里的邮编 "00123" 是字符串,前导零有意义时应保留;改成数字就改变了类型与编号表示。但不要擅自改接口约定:接收方要求数字还是字符串,应以双方的数据结构约定为准。
对比也有口径。页面说明:对象忽略键顺序,数组按索引对比,数字比较原文,因此 1 和 1.0 会显示差异。这适合发现序列化变化,不表示数学上二者数值不同。
导出 CSV 后还要再检查一遍。页面说明支持对象或对象数组,可按 JSON Pointer 展平;但 CSV 没有列类型,长编号、前导零列应在电子表格导入时设为文本。公式前缀防护不能把 CSV 变成 JSON 的无损备份,原始 JSON 仍应保留。
XML、YAML、CSS:不能拿同一种“校验通过”来理解
**XML:**对应工具检查标签匹配、嵌套、单一根元素、属性引号等格式良好条件,不检查 XSD 或 DTD。页面也提醒混合内容、空白敏感文档要谨慎处理。文字与子元素交错时,换行缩进可能影响使用方式,替换原件前应复核。若处理的是多语言 HTML 网页而非 XML 数据,可另看HTML 翻译与 SEO 检查清单。
**YAML:**页面说明使用空格规范缩进,并保留注释、文档分隔符。能解析不等于符合 Kubernetes 或应用配置 schema。缩进层级必须有意安排;字符串里的标点、特殊值可能产生歧义时要正确加引号。不要把共用界面上针对其他语言的选项,当成 YAML 都支持的能力。
**CSS:**格式化是为了看清声明和嵌套;压缩是制作交付副本。CSS 压缩页说明使用 CSSO,可处理空白和规则合并等,不只是删换行。不要承诺固定压缩率或必然提速;保留源文件,检查选项,并测试响应式状态与覆盖规则。SCSS、Less 格式化也不是把它们编译成可直接运行的 CSS。
浏览器工作记录还对同一份内置 CSS 示例测试了英文格式化与压缩页:格式化保留 #dddddd 和 #ff0000,压缩结果改写为 #ddd 和 red。这说明该例发生了值写法优化,不只是删换行;不能据此推导普遍压缩率或保证所有样式表都可直接上线。
复制出去之前的五个检查
- 先处理语法、重复键,再排序、对比。
- 查字段类型、完整编号,以及至少一个代表性深层字段。
- 交给下游的是可读 JSON、紧凑 JSON,还是分析用 CSV?不要混为一种格式。
- 专用 JSON 页说明的输入上限为 1 MiB、100,000 个值、128 层嵌套。其他格式化页的 5 MB 限制不能套到这里。
- 示例里先去掉密钥和客户资料。JSON 页说明处理在浏览器完成,可选草稿保存在 localStorage;这不等于整个网站没有网络请求,广告仍按全站配置加载。共用设备上不要开启敏感内容的草稿保存。
下一步,把方法用到你的业务里
用 Google 或邮箱验证码开始免费工具;需要公司监控与团队权限时,再创建公司并比较 Pro 方案。
个人账号按免费额度使用;另建新公司才可获 7 天 Pro 试用,试用不含付费月度积分。



