yaml-cpp读取基础YAML结构需先用YAML::LoadFile()加载，再检查节点存在性（如if(node["host"]））和类型（IsMap/IsSequence），最后调用as<T>()安全转换；须避免空节点解引用、越界访问及BOM编码问题。
用 yaml-cpp 读取基础 YAML 结构
直接用 yaml-cpp 是 C++ 解析 YAML 最成熟的选择，它支持读写、类型转换和节点遍历。别自己手写解析器——YAML 的缩进、锚点、合并标记（&/* ）等特性极易出错。
安装后（如 Ubuntu： sudo apt install libyaml-cpp-dev），关键步骤是：加载文本 → 检查是否为有效文档 → 按键取值。
- 必须用
YAML::LoadFile()或YAML::Load()加载，返回YAML::Node -
YAML::Node支持类似 map 或 vector 的访问方式：node["key"]、node[i] - 访问前务必检查存在性：
if (node["host"]) {...}，否则抛YAML::TypedBadConversion - 类型转换需显式调用：
node["port"].as<int>()，不能直接赋值给int
处理嵌套结构和数组时的常见崩溃点
YAML 中的嵌套对象或列表很容易让新手掉坑里：空节点、类型不匹配、越界访问都会导致运行时异常，而不是编译错误。
- 用
node.IsMap()/node.IsSequence()/node.IsNull()先判断类型，再操作 - 遍历 sequence 推荐用范围 for：
for (const auto& item : node["list"]) { ... }，避免手动索引越界 - 访问嵌套键链时别连写
node["a"]["b"]["c"]——中间任意一级为空就 crash，应逐级判空 - 若 YAML 含
!!null或省略值（如timeout:后无内容），.as<int>()会 throw，改用.as<int>(default_value)提供默认值
中文键名、注释与跨平台路径问题
YAML 文件含中文键或值本身没问题，但实际使用中容易因编码或路径引发问题。
立即学习“C++免费学习笔记（深入）”；
-
yaml-cpp默认按 UTF-8 解析，确保文件保存为 UTF-8 无 BOM；Windows 记事本另存时要选“UTF-8”而非“ANSI” - 注释（
#开头）会被自动忽略，不影响解析，但别把注释放在行末键值对后面——某些旧版库解析不稳定 - 路径传给
YAML::LoadFile()时，用正斜杠/或双反斜杠\，单反斜杠在字符串字面量里是转义符，易出错 - Linux/macOS 下路径区分大小写，
Config.yaml和config.yaml是两个文件——开发时别依赖“好像能打开”
遇到 “bad conversion” 或 “invalid node” 怎么快速定位
这两类错误最常发生在类型断言失败或空节点解引用时，不是语法错，而是运行时逻辑错。
- 加一句
std::cout << node 打印整个节点，能看到实际结构和类型（<code>Null、Scalar、Map等） - 用
node["key"].IsDefined()替代!node["key"].IsNull()判断是否存在——前者涵盖未定义和 null 两种情况 - 如果 YAML 用了锚点（
&ref）和别名（*ref），确保yaml-cpp版本 ≥ 0.6.0，老版本不完全支持 - 调试时临时把
try/catch(YAML::Exception& e)包住解析块，并打印e.what()，错误信息里通常带行号
YAML 解析真正的复杂点不在语法，而在你假设的结构和实际文件结构不一致——多打几行日志验证节点类型，比反复改代码快得多。
