yaml-cpp读取配置前必须确认三件事：已安装库并正确链接、头文件路径可用、YAML文件路径相对于可执行文件工作目录；否则YAML::LoadFile会抛异常或段错误。
yaml-cpp 读取配置前必须确认的三件事
不装库、不链接、不初始化，YAML::LoadFile 会直接抛 YAML::BadFile 或段错误。这不是代码写错了，是环境没搭对。
- 确认已用包管理器安装（如
sudo apt install libyaml-cpp-dev）或从源码编译安装到系统路径；头文件路径要能被#include <yaml-cpp></yaml-cpp>找到 - 链接时必须加
-lyaml-cpp，CMake 用户得写target_link_libraries(your_target yaml-cpp)；漏掉就报 undefined reference 到YAML::LoadFile等符号 - YAML 文件路径必须是绝对路径，或相对于可执行文件当前工作目录的相对路径——不是相对于源码目录，也不是相对于
main()所在 cpp 文件位置
用 YAML::LoadFile 读取后怎么安全取值？
直接 node["host"] 拿不到值还崩溃？因为 YAML 节点默认不检查是否存在，也不做类型转换。它返回的是一个代理对象，访问非法 key 或类型错配时行为未定义。
- 先用
node["host"].IsDefined()判断字段是否存在，否则as<:string>()</:string>会 throwYAML::TypedBadConversion<:string></:string> - 类型必须显式匹配：数字字段不能直接
as<:string>()</:string>，要用as<int>()</int>或as<double>()</double>；浮点数写成3.14是double，写成3是int - 嵌套结构用链式调用，但每层都要检查：
node["database"]["port"].IsDefined() && node["database"]["port"].IsScalar()，否则越界访问静默失败
为什么 YAML::Node 不能直接传给函数或存进容器？
它内部是引用计数的共享指针，拷贝开销小，但生命周期依赖原始 YAML::Node 根节点。一旦根节点（比如 YAML::LoadFile 返回的那个）析构，所有子节点变悬空，再访问就段错误。
- 别把子节点单独保存为成员变量：
class Config { YAML::Node port_; };—— 这很危险，除非你确保根节点一直活着 - 推荐做法：每次需要时从根节点重新取，或用
.as<t>()</t>提前转成std::string、int等值类型存起来 - 如果真要缓存结构体，自己封装一层，用值语义存储数据，而不是裸存
YAML::Node
中文路径或 UTF-8 内容读取失败怎么办？
YAML::LoadFile 底层用 C stdio 打开文件，不处理编码转换。Windows 上中文路径会因 locale 不匹配直接失败；Linux/macOS 虽支持 UTF-8 路径，但若 YAML 文件本身含 BOM 或编码混杂，解析仍可能中断。
立即学习“C++免费学习笔记（深入）”；
- 路径统一用 UTF-8 字符串，Windows 下建议转成宽字符再用
_wfopen—— 但yaml-cpp不支持，所以最稳方案是避免中文路径 - YAML 文件保存为无 BOM 的 UTF-8；用
file config.yaml确认输出是UTF-8 text，不是UTF-8 Unicode text（后者带 BOM） - 内容含中文没问题，但别在 key 里用空格或冒号等 YAML 特殊字符，key 建议全用下划线命名，比如
db_name而非数据库名
最容易被忽略的是根节点生命周期和路径解析上下文——这两个点不出问题时一切顺利，一出就是段错误或随机崩溃，调试时很难关联到 YAML 读取逻辑上。
