优先用 yaml-cpp，除非需静态链接或零依赖；它封装 libyaml、提供 C++ 风格 Node 访问和类型转换，而 libyaml 为事件驱动、嵌套深时易出错。
用 libyaml 还是 yaml-cpp？选错库会卡在解析第一层
直接结论：优先用 yaml-cpp，除非你被要求静态链接或必须零依赖。它封装了 libyaml 的 C 接口，提供 C++ 风格的 Node 树访问，支持 operator[] 和类型转换，写起来接近 JSON 解析体验；而原生 libyaml 是事件驱动（SAX 风格），嵌套深时得自己维护栈状态，容易漏掉 YAML_SEQUENCE_START_EVENT 或误判缩进层级。
常见错误现象：yaml-cpp 报 YAML::ParserException 但没指明哪行——大概率是缩进混用了 Tab 和空格，或某级 mapping 缺了冒号；libyaml 则可能静默跳过整个块，因为 parser 在某个 event 后没继续调 yaml_parser_parse()。
-
yaml-cpp要求编译时链接-lyaml-cpp，且 CMake 中需find_package(yaml-cpp REQUIRED) - 若配置文件含中文键名或值，确保文件保存为 UTF-8 无 BOM，
yaml-cpp0.8+ 默认支持，旧版需手动设置YAML::LoadFile()前调std::locale::global(std::locale("")) - 不建议用
libyaml手动解析多级嵌套——比如database.connections[0].timeout_ms这种路径，自己递归遍历yaml_event_t太容易崩在 null pointer 或类型误判上
YAML::Node 怎么安全取嵌套字段？别硬写 node["a"]["b"]["c"].as<int>()</int>
直接链式调用 operator[] 在任意一级不存在时会抛 YAML::BadSubscript，不是返回空或默认值。生产环境必须先校验路径存在性。
使用场景：读取类似 features.auth.jwt.expiry_hours 这类可选配置，缺了不能 crash，得 fallback。
立即学习“C++免费学习笔记（深入）”；
- 用
node["features"]["auth"]["jwt"]前，逐级检查IsDefined()，例如：if (node["features"] && node["features"]["auth"] && node["features"]["auth"]["jwt"]) - 更简洁写法：封装一个
safe_get<int>(node, {"features", "auth", "jwt", "expiry_hours"}, 24)辅助函数，内部用循环 +IsDefined()判断 - 注意
node["x"]["y"]返回的是临时YAML::Node引用，不能存const auto& sub = node["x"]["y"]后再用——若node是局部变量且已析构，引用悬空 - 数组索引越界不会报错，
node["list"][100].as<string>()会返回空字符串，得先用size()判长度
YAML 中的锚点（&anchor）和别名（*anchor）怎么避免解析后数据错乱
锚点/别名是 YAML 的引用机制，yaml-cpp 默认启用，但很多人不知道它会让多个 YAML::Node 对象指向同一内存——修改其中一个，其他“别名”节点跟着变，这在配置热重载时引发诡异 bug。
性能影响：启用锚点解析会增加解析时间约 15–20%，因为要维护引用映射表；禁用后，所有 *anchor 会被当作普通字符串字面量处理（即读出来是 "*db_config" 而非实际内容）。
- 若配置文件不含锚点，编译时加
-DYAML_CPP_DISABLE_ANCHOR可关掉该逻辑，减小二进制体积 - 若必须支持锚点，且需深拷贝某子树（比如提取一份独立副本用于线程局部缓存），不能直接赋值：
auto copy = node["section"]—— 得用YAML::Clone(node["section"]) - 调试时发现两个看似无关的
Node修改互相影响，第一反应就是查 YAML 源码里有没有&和*，再确认是否用了Clone()
多文档 YAML（---\n...\n---）怎么逐个解析而不丢数据
YAML::LoadAll() 返回 std::vector<YAML::Node>，但新手常误以为它自动跳过注释或空白文档——其实空文档（只有 --- 或 ...）也会生成一个空 Node，IsMap()/IsSequence() 全为 false，容易被忽略导致后续逻辑空指针。
使用场景：Kubernetes 风格的配置文件，一个 YAML 文件里塞 Service、Deployment、ConfigMap 多个资源定义。
- 务必对每个
YAML::Node调用IsDefined()再判断类型，不能假设LoadAll()返回的每个元素都有效 - 若某文档结构固定（如首层必为
kind: Config），可用node["kind"].as<std::string>() == "Config"过滤，避免处理到空节点 -
YAML::Load()只读第一个文档，遇到第二个---就停，别指望它自动合并或跳转
最易被忽略的点：YAML 缩进不是“空格数”，而是“相对于上一层的相对缩进”，yaml-cpp 对混合缩进极其敏感——哪怕只有一行用 Tab 缩进，整个文件解析都会失败，且错误位置提示往往偏移 2–3 行。上线前务必用 yamllint --strict 扫一遍，比 runtime 报错成本低得多。
