YAML转JSON，为何注释没了？

YAML注释通常不会进入转换后的JSON，因为标准JSON没有注释语法。配置值能够迁移，不意味着原文件的说明文字、排版和书写方式也会保留。需要长期维护的配置，应将可执行数据与人工解释分别管理，避免转换后丢失运维背景。

2026年11月7日，www.kkce.com 实拍。人工编写含两行注释的YAML；实际JSON输出只有数据字段，未包含原注释。

用短配置验证注释的去向

此次在KKCE YAML与JSON互转输入自建配置：服务名、30秒间隔和启用标记，另外写两行注释。执行后，右侧保留三个数据字段，注释没有出现。截图是这份小样本的结果，没有测试全部YAML高级语法，也不代表任意配置均可完整迁移。

注释不承担实际参数含义

以井号开头的说明用来帮助阅读，通常不参与应用取得的值。若单位、默认值或取值范围只写在注释里，转换出的数值本身不会携带这些解释。接口要传达单位时，应遵循既有数据契约，而非指望转换器猜测说明文字。

不要随意把说明塞进新字段

为了保留注释而增加字段，可能被严格配置校验拒绝，或改变下游处理。若系统允许元数据，可按正式定义保存；否则使用配套文档、配置模板或版本记录。不要给JSON手工插入注释后，仍把它当作可由标准解析器读取的文件。

验收兼顾数据与维护能力

逐项检查转换前后的数值类型、列表内容及缺省行为，再确认操作人员能找到说明资料。快快测提供便捷的格式互换视图，生产迁移则应由目标系统验证。保留原稿及变更原因，让下一次调整无需重新猜测参数设计意图。