在方括号里写了alpha、beta,最后还留着一个逗号,YAML转换却没有报错。于是有人把这段内容直接当JSON复制到接口中,随后才遇到解析失败。相似的括号外观,并不代表两种格式接受完全相同的语法。

2026年11月19日,在YAML与JSON转换工具输入flow风格的序列与映射,序列最后一项、映射最后一项后都保留逗号。本次输出正常生成JSON,names是两项数组,options包含enabled为true;输出没有照抄末尾逗号。

YAML的flow序列与映射含尾逗号,本次仍转换为不带尾逗号的JSON
YAML的flow序列与映射含尾逗号,本次仍转换为不带尾逗号的JSON

格式相似,仍要完整转换

YAML允许flow集合在最后一项后带一个逗号,但这个逗号不是一个额外的空元素。本次再把同样的内容写成缩进式序列和映射,得到的JSON值相同。这里改变的是YAML的呈现方式,不能据此推导JSON也支持同一种尾逗号。

本机JSON.parse另外读取已经补好双引号的三份文本:两项数组带尾逗号会报SyntaxError,去掉尾逗号可以读取,单字段对象带尾逗号也会报错。刻意先补齐字符串引号,是为了把本次失败限定到尾逗号,而不是让缺少引号成为另一个变量。

本机记录把YAML转换结果与严格JSON解析分开;尾逗号不是JSON的额外空值
本机记录把YAML转换结果与严格JSON解析分开;尾逗号不是JSON的额外空值

不要把格式容错当作接口约定

如果目标要求JSON,应复制工具生成的JSON结果,并再次按目标环境校验,而不是仅把原文的冒号或引号改几处。YAML里还存在不带引号的字符串、不同标量类型等写法,零散替换很容易遗漏其他格式差异。

也不要用全局替换删除所有“逗号加右括号”的字符组合。正文字符串里可能原本就包含这些符号,文本替换并不知道它处于字符串还是集合结构。使用对应解析器读取,再序列化为目标格式,能够明确处理的是数据结构;格式转换后仍要核对类型与字段。

目标解析器报错时,可以参考JSON标点的逐层检查方法。保留YAML原稿与生成的JSON副本,分别标注消费端需要哪一种格式,避免下一次维护时把能在YAML中通过的源码直接交给只接受JSON的接口。