应优先使用yaml-cpp而非libyaml；常见解析失败源于缩进混用Tab、UTF-8 BOM、中文locale未设置或注释后冒号无换行；安全访问需逐级IsDefined()校验，避免链式调用静默失败；as<T>()返回零值非异常，需结合IsDefined()和IsNull()区分缺失与null；注意递归深度限制及Node引用语义。
直接用 yaml-cpp，别碰 libyaml 手动解析——后者第三层嵌套就开始漏字段、崩指针、静默跳过内容；yaml-cpp 提供树形 YAML::Node 和安全的 operator[]，是唯一能兼顾可读性、健壮性和开发效率的选择。
为什么 YAML::LoadFile() 一调就抛 YAML::ParserException？
这不是 YAML 语法错，而是缩进或编码惹的祸。
-
Tab和空格混用：YAML 严格要求纯空格缩进，Tab会被当作非法字符直接抛异常（错误位置常显示为第一行） - 文件带 BOM：
UTF-8 with BOM的配置文件在yaml-cpp0.7.x 及更早版本中必失败；务必用编辑器另存为“UTF-8 无 BOM” - 中文键名未声明 locale：旧版需在
YAML::LoadFile()前加std::locale::global(std::locale(""))；yaml-cpp0.8+ 默认支持 UTF-8，但前提是文件本身无 BOM - 注释后紧跟冒号：如
host: # localhost后没换行，某些版本会误判标量结束，导致后续结构错位
如何安全访问多级嵌套字段（比如 database.connections[0].timeout_ms）？
链式调用 node["a"]["b"]["c"].as<int>()</int> 是生产环境雷区：任意一级缺失都会返回零值（如 0 或空串），逻辑静默失败。
-
node["a"]在未定义时会隐式构造空节点，再取["b"]仍是空节点，不会报错 —— 所以root["a"]["b"].IsDefined()不能代替逐级判断 - 正确做法是逐级检查：
if (root["database"] && root["database"]["connections"] && !root["database"]["connections"].empty())；注意empty()比size() == 0更安全（未定义 node 的size()返回0） - 数组索引前必须校验长度：
if (root["database"]["connections"].size() > 0)，再取[0]；否则root["..."][0]返回空节点，不崩溃但后续as<int>()抛YAML::BadConversion - 封装辅助函数比重复
if更可靠，例如：safe_get<int>(root, {"database", "connections", "0", "timeout_ms"}, 5000)，内部用循环 +IsDefined()判定路径有效性
为什么 as<string>() 返回空串、as<int>() 返回 0？
这是 yaml-cpp 的默认行为：对未定义或类型不匹配的节点，as<T>() 返回 T{}（即 std::string()、int() 等零值），不是异常。
立即学习“C++免费学习笔记（深入）”；
- 永远别依赖“返回空值 = 字段缺失”：它也可能是配置里真写了
timeout_ms: null或timeout_ms:（省略值） - 显式设默认值：用
node["timeout"].as<int>(3000)</int>，而不是靠as<int>()返回0做逻辑分支 - 想区分“缺失”和“显式 null”，用
node["timeout"].IsDefined() && !node["timeout"].IsNull() - 递归深度超限（如嵌套 >10 层）也会触发
YAML::ParserException: nested too deep，需加载前调用YAML::SetMaxRecursionDepth(20)
最易被忽略的是 YAML::Node 的引用语义：它指向内部解析树，不能脱离原始 YAML::Node 存活；函数里直接 return doc["config"] 是悬空风险，要持久化必须复制值，比如 std::string host = node["host"].as<:string>()</:string>。
