YAML::Load不能直接解析std::string，必须用c_str()转为C风格字符串；需确保无BOM、无前导空白，注意字符串生命周期和节点线程安全性。
YAML::Load 不能直接解析裸字符串，必须用 YAML::Node 包装
直接传 std::string 给 YAML::Load() 会编译失败或运行时抛 YAML::ParserException：它只接受 const char*（C 风格字符串）或 std::istream&，不接受 std::string 的隐式转换。常见错误写法：YAML::Load(my_str) —— 这实际调用了 YAML::Load(const std::string&) 的重载？错，libyaml-cpp 0.8+ 已移除该重载。
正确做法是显式转为 C 字符串：
- 确保字符串以
\0结尾（std::string::c_str()满足） - 用
YAML::Load(my_str.c_str())，不是YAML::Load(my_str) - 如果字符串含中文或 UTF-8 特殊字符，确认源文件保存为 UTF-8 且无 BOM；
libyaml-cpp原生支持 UTF-8，但 BOM 会导致解析失败
解析失败时的典型错误信息和定位方法
最常遇到的是 YAML::ParserException，错误信息类似：yaml-cpp: error at line 1, column 1: illegal map value。这不是语法错，而是底层解析器读到了非法起始字符（比如字符串开头有不可见空格、BOM、或换行符）。
- 用
my_str[0]打印首字节，检查是否为0xEF（UTF-8 BOM 开头） - 用
my_str.find_first_not_of(" \t\n\r")判断是否有前导空白；有则YAML::Load会报illegal document start - 调试时可先写入临时文件再加载：
std::ofstream f("tmp.yaml"); f —— 如果文件能加载而字符串不能，基本锁定是字符串内容问题
从字符串加载后如何安全访问嵌套字段（避免 segfault）
YAML::Node 是引用语义，未初始化的节点访问 ["key"] 不会崩溃，但返回一个空节点；后续调用 as<int>()</int> 会抛 YAML::BadConversion。别假设结构一定存在。
立即学习“C++免费学习笔记（深入）”；
- 用
node["a"]["b"].IsDefined()检查路径是否存在 - 用
node["a"]["b"].IsScalar()确认是值而非对象/数组 - 避免链式调用：
node["a"]["b"]["c"].as<int>()</int>→ 改成逐层判断，或用node["a"]["b"]["c"].as<int>(0)</int>提供默认值 - 注意类型匹配：YAML 中
123是 int，"123"是 string，123.0是 double ——as<int>()</int>对 double 会抛异常
性能与线程安全注意事项
YAML::Load() 解析过程不是轻量操作：它要构建完整 AST，对 >10KB 字符串会有明显延迟（实测 50KB YAML 字符串在 i7 上约 0.8ms）。频繁解析同一字符串建议缓存 YAML::Node。
-
YAML::Load()是线程安全的，但返回的YAML::Node**不是**线程安全的 —— 多线程读同一节点无需锁，但若某线程修改了原始 YAML 文本并重新Load()，其他线程持有的旧节点仍有效（因内部数据深拷贝） - 不要在循环里反复
YAML::Load(str.c_str())；若字符串不变，提取一次存为 const 变量 - 若需多次查询不同字段，优先用
node["key"]缓存子节点引用，而不是重复索引
my_str.c_str() 返回指针仅在 my_str 有效期内有效。若把 YAML::Load(my_str.c_str()) 结果存为全局变量，但 my_str 是函数局部变量，那后续访问节点可能读到野内存。 
