YAML-CPP读取配置前须确认三件事：正确链接库、捕获YAML::Exception异常、验证文件路径；安全取值需检查存在性、用默认值、判类型、防越界；Node为引用语义，禁返局部子节点；UTF-8无BOM，注释位置受限，特殊key需引号，深嵌套需调YAML_MAX_DEPTH。
YAML-CPP 读取配置文件前必须确认的三件事
不装好依赖、不处理异常、不检查节点类型，YAML::LoadFile 一调就崩，不是代码写错了，是环境和假设没对齐。
- 确认已用
cmake正确链接yaml-cpp库（常见坑：find_package(YAML_CPP REQUIRED)后漏掉target_link_libraries(your_target yaml-cpp)） -
YAML::LoadFile抛异常不捕获 → 程序直接 terminate；必须包在try/catch (const YAML::Exception& e)里 - YAML 文件路径是相对路径时，工作目录 ≠ 可执行文件目录 ≠ 源码目录 —— 建议先用
std::filesystem::current_path()打印确认，或改用绝对路径调试
用 YAML::Node 安全取值的四种常用模式
YAML 节点不是万能字典，直接 ["key"] 访问未定义字段会静默返回空节点，后续调 as<int>()</int> 就抛 YAML::BadConversion。
- 存在性检查优先：
if (node["port"]) { int p = node["port"].as<int>(); }</int> - 带默认值取法：
int timeout = node["timeout"].as<int>(30);</int>—— 仅当节点存在且可转为int才用其值，否则用30 - 类型安全转换：
if (node["debug"].IsScalar()) { bool d = node["debug"].as<bool>(); }</bool>，避免把字符串"false"当false解析（YAML-CPP 默认不自动转换字符串布尔） - 数组遍历必须判类型：
if (node["servers"].IsSequence()) { for (const auto& srv : node["servers"]) { ... } }，否则for循环在非数组上触发未定义行为
YAML::Node 生命周期与内存管理的隐含约束
所有从 YAML::Load 或 YAML::LoadFile 返回的 YAML::Node 都是引用语义 —— 它们指向内部解析树，不能脱离原始 YAML::Node 存活。
- 不要返回局部
YAML::Node的子节点：函数内return doc["config"];是危险的，doc出作用域后子节点失效 - 不要长期保存子节点指针或引用；需持久化时，复制值：
std::string host = node["host"].as<:string>();</:string> - 大文件解析后，
YAML::Node占用内存不会自动释放 —— 若只读一次就丢弃，建议用局部作用域包裹，或显式置空：node.reset();
中文路径、注释、特殊字符的实际兼容表现
YAML-CPP 默认使用 libyaml，对 UTF-8 友好，但对 BOM 和混合编码零容忍 —— 不报错，只静默截断。
立即学习“C++免费学习笔记（深入）”；
- Windows 下用记事本保存 YAML → 自动加 BOM →
YAML::LoadFile失败（错误信息：invalid Unicode code point）；改用 VS Code 或 Notepad++ 保存为「UTF-8 无 BOM」 - 注释不影响解析，但不能出现在映射键行末（如
port: 8080 # comment合法，port: # comment合法，但port # comment: 8080语法错误） - 含空格或特殊符号的 key 必须引号包裹：
"api key": "xxx"，否则解析失败；YAML::Node::operator[]查找时也得用相同字符串（包括引号）
最常被忽略的是节点嵌套层级过深时的栈溢出风险 —— libyaml 默认递归限制 100 层，超限报 recursion limit exceeded，需编译时定义 YAML_MAX_DEPTH 调整，而非运行时控制。
