yaml-cpp 不支持重复 key，后出现的值会覆盖前一个，这是遵循 YAML 1.2 标准的规范行为；默认不报错，需通过 yamllint、ryml 或预处理脚本主动检测。
yaml-cpp 不支持重复 key，遇到重名时后出现的值会直接覆盖前一个——这不是 bug，是规范行为。YAML 1.2 标准明确要求 mapping 中 key 必须唯一，libyaml 和 yaml-cpp 都严格遵循这一点。
为什么读取时看不到重复 key 的报错？
因为 YAML::LoadFile() 默认不校验 key 唯一性，它只按顺序解析并覆盖：遇到 port: 8080，再遇到 port: 9000，最终 node["port"].as<int>()</int> 返回的就是 9000。
- 不会抛异常，也不会警告
- 即使你用
YAML::LoadFile("config.yaml", YAML::LoadOptions::ThrowOnDuplicateKey)（0.8.0+），也仅在解析阶段触发YAML::ParserException，且该选项默认关闭 - 很多项目压根没开这个开关，导致配置静默失效
如何检测 YAML 文件里是否存在重复 key？
必须手动遍历原始 token 流或改用支持校验的解析器。yaml-cpp 本身不暴露 token 层，所以推荐两种务实做法：
- 用
ryml替代：它原生保留所有 token 位置信息，可遍历rfl::Node并检查node.key().data()是否重复出现 - 预处理脚本检查：用 Python 的
pyyaml加载后判断len(data.keys()) != len(list(data))（因 dict 自动去重） - 若坚持用 yaml-cpp：在调用
YAML::LoadFile()前，先用正则粗筛（不严谨但快）：grep -n "^[a-zA-Z_][^:]*:" config.yaml | cut -d: -f1看是否有同一行号多次命中
重复 key 导致的典型故障现象
最常见的是服务端口、超时时间、开关字段被意外覆盖，例如：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
server: port: 8080 timeout: 30 port: 9000 # ← 这行生效，但人眼容易忽略 debug: true
-
node["server"]["port"].as<int>()</int>返回 9000，而非预期的 8080 - 若配置生成自模板引擎（如 Jinja2），重复插入逻辑未加 guard，问题更隐蔽
- CI/CD 流水线中，不同环境配置合并时易引入冲突，但 yaml-cpp 不报错，上线后才暴露
安全写法：避免依赖 key 覆盖，主动防御
不要指望“后写入者胜出”是可控逻辑；应把重复 key 视为配置错误。关键动作是：
- CI 阶段加入
yamllint --strict config.yaml，它默认启用key-duplicates规则 - 加载配置后立刻做结构验证：
if (cfg["server"] && cfg["server"]["port"]) { /* ok */ }，但注意这不能发现重复 key，只能防空节点 - 对敏感字段（如
database.url、auth.token）加白名单校验，读取后比对原始文件行号（需配合ryml或预解析）
真正难防的不是语法错误，而是语义上“合法但不合理”的重复——比如两个 feature_flag: true 分别来自不同 include 片段，yaml-cpp 合并后只剩一个，却没人知道另一个被吞了。
