YAML 转 JSON 前，检查这五类配置差异

轻工具编辑 · 配置与数据处理

用配置片段检查注释、空值、字符串编号、数组层级与锚点展开，避免把格式转换成功误认为配置可部署。

注释和锚点不是 JSON 的组成部分

YAML 中的 # 注释用于给人阅读，JSON 对象中没有对应注释语法。锚点、别名和合并键可以减少配置重复，但转换后通常展开为普通对象。这意味着再次转回 YAML 时，不能期待恢复原先的注释位置或锚点名称。需要长期人工维护的配置，应保留 YAML 原稿。

空值与空字符串是两种不同数据

例如 token: 没有显式值，通常会变成 JSON 的 null；token: "" 才是空字符串。接收程序可能对 null 使用默认值，却把空字符串理解为清空配置。转换时应检查业务语义，而不仅是比较字符数量。当前转换器对顶层 false、0、null 还有空输出限制，可以使用对象字段构造测试样例。

编号与布尔值要看类型

version: "0012" 表达字符串编号，version: 12 表达数值。把编号写成字符串可以保留前导零，也更容易避免长整数精度问题。对于日期样式字符串、布尔值写法和带特殊符号的文本，建议使用清楚的引号与规范写法，并在转换后的 JSON 中检查是否仍是预期类型。

缩进正确不代表层级正确

同一字段缩进两格或四格，有时都能解析，却落到不同的父对象中。把列表写成一个字符串也可能不报语法错误。转换后重点查看数组是否仍为数组，以及每个配置项属于哪个对象。多个由 --- 分隔的文档应分别处理，避免把整组部署文件当成一个对象。

最后在目标系统验证

格式转换器不知道应用要求的字段名、版本和权限，也不会检查引用的文件是否存在。复制结果后，先在测试环境使用目标工具的配置检查命令或校验接口。保留原始文件、脱敏样例和预期输出，后续升级配置格式时才能判断变化发生在哪里。