跳到文章正文
XUNL / FIELD NOTES

JSON 格式化、压缩与解析:严格语法、大整数及 XML/YAML/CSS 工具选择

从真实内置订单示例检查 JSON 数字原文、尾随逗号与字段路径,分清 XML、YAML、CSS 格式化和压缩的用途与限制。

Read in English ↗
排版封面(非界面截图):JSON 格式化、严格语法、大整数与 XML、YAML、CSS 工具选择

接口返回一整行 JSON 时,先别急着“排好看”:先确认语法有效,再查字段和类型,最后才选格式化、压缩或导出。可以从JSON 格式化与在线解析开始;拿到的是 XML、YAML 或样式表,就换对应工具。缩进整齐不代表订单金额正确,也不等于通过业务系统的校验。

本文依据 2026 年 11 月 18 日(Asia/Shanghai)查阅的 JSON 工作台公开说明及相关工具页编写。下文的内置示例有浏览器工作记录及中英文原始截图支持;其他能力仍明确区分为页面说明,不冒充逐项实测。

先分清:阅读、压缩,还是找字段

手头的问题选哪个工具或操作还要核对什么
接口响应挤成一行JSON 的“格式化”字段类型、嵌套内容、数字原文
需要紧凑 JSONJSON 的“压缩”不是删字段或改字符串里的空格
找深层字段结构树、JSON Pointer路径是否指向想找的值
看 Sitemap、RSS 等 XMLXML 格式化格式良好不等于符合 XSD
整理配置文件YAML 格式化应用自己的配置规则另查
阅读 CSS、SCSS、LessCSS 格式化页面样式另做浏览器测试
准备精简的 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 工作台载入示例后格式化,右侧保留订单号 9123372036854000123 与价格 129.00 的原写法

找字段: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。这说明该例发生了值写法优化,不只是删换行;不能据此推导普遍压缩率或保证所有样式表都可直接上线。

复制出去之前的五个检查

  1. 先处理语法、重复键,再排序、对比。
  2. 查字段类型、完整编号,以及至少一个代表性深层字段。
  3. 交给下游的是可读 JSON、紧凑 JSON,还是分析用 CSV?不要混为一种格式。
  4. 专用 JSON 页说明的输入上限为 1 MiB、100,000 个值、128 层嵌套。其他格式化页的 5 MB 限制不能套到这里。
  5. 示例里先去掉密钥和客户资料。JSON 页说明处理在浏览器完成,可选草稿保存在 localStorage;这不等于整个网站没有网络请求,广告仍按全站配置加载。共用设备上不要开启敏感内容的草稿保存。
下一步,由你选择

下一步,把方法用到你的业务里

用 Google 或邮箱验证码开始免费工具;需要公司监控与团队权限时,再创建公司并比较 Pro 方案。

个人账号按免费额度使用;另建新公司才可获 7 天 Pro 试用,试用不含付费月度积分。

按角色找到下一步工具 →

← 返回全部文章

订阅教程更新:有新教程时最多每七天一封 →