YAML少缩进一层，配置就变了吗？

YAML缩进少一层，可能仍然语法正确，却改变了配置所属的层级。解析成功只代表结构能够建立，不代表字段还位于程序预期的位置。排查“配置没生效”时，应先展开数据树，确认关键值挂在哪个父节点下，再检查业务是否认识这一条路径。

2026年11月7日，www.kkce.com 实操截图。主图checks位于根层；下图列表相同，但归入service，JSON路径发生改变。两份YAML都合法，语义结构不同；未部署或重载任何服务配置。

两份有效输入对照字段路径

本次在快快测YAML与JSON转换先将checks放在根层，再将同样的列表缩进到service之内。两次都成功生成JSON，但路径分别为checks与service.checks。正文主图及对照图记录结构差别，转换没有替任何真实服务加载配置。

缩进表达关系而非视觉排版

在本例映射结构中，缩进决定checks归属于哪个对象。把它与service对齐，就不再是service的子项。列表的内容保持一样，也无法抵消父级改变。审查时最好按路径描述预期，例如明确某设置应在服务对象内，避免只说“这一行看起来对了”。

语法检查之外还需要模式验证

应用可能忽略未知根字段，也可能要求某个对象包含指定键。应使用匹配版本的配置规范或校验机制，检查必填项、允许位置和类型。若程序默默采用默认值，还应从启动日志或有效配置输出中确认实际加载结果。

变更前后比较解析后的树

对结构化结果作差异检查，比只看空格改了几个更能发现字段移动。KKCE的转换结果能辅助阅读层级，最终仍需在目标应用中验证。提交配置变更时写明路径变化及预期行为，减少“语法无错但设置无效”的反复排查。