优先用yaml-cpp，它提供C++风格API、支持operator[]和类型转换、自动管理内存；libyaml是纯C接口，需手动处理事件流和内存，易因未链接-lyaml或缺少extern"C"导致undefined reference错误。
用 libyaml 还是 yaml-cpp？选错库会卡在编译阶段
直接结论：优先用 yaml-cpp，它提供 C++ 风格的 API，支持现代 C++（C++11 起），而原生 libyaml 是纯 C 接口，需要手动管理节点、事件和内存，写起来像在调用系统 API。
常见错误现象：undefined reference to yaml_parser_initialize —— 这是误用了 libyaml 的 C 头但没链接 -lyaml，或混用了 C 头与 C++ 编译器未加 extern "C" 包裹。
-
yaml-cpp安装简单：apt install libyaml-cpp-dev（Ubuntu/Debian），或用 vcpkg/conan 拉取 - 头文件统一为
#include <yaml-cpp></yaml-cpp>，不需额外extern "C" - 链接时加
-lyaml-cpp，注意不是-lyaml - 若项目用 CMake，推荐用
find_package(yaml-cpp REQUIRED)，避免硬编码路径
YAML::LoadFile() 报 BadFile 或解析空节点？检查路径和编码
YAML::LoadFile() 会静默失败（抛 YAML::BadFile 异常）而非返回 nullptr，且不提示具体原因。最常见的是相对路径错位或文件含 BOM / UTF-16 编码。
- 确认路径有效：在代码里加
std::ifstream f(filename); std::cout 先验证 - Linux/macOS 下用
file -i config.yaml查看实际编码；Windows 记事本保存的 YAML 很可能带 UTF-8 BOM，yaml-cpp0.8+ 才支持，旧版会直接报InvalidScalar - 不要依赖当前工作目录：用
argv[0]解析出可执行路径再拼接配置路径，或传绝对路径 - 异常捕获必须写全：
try { YAML::Node node = YAML::LoadFile("a.yaml"); } catch (YAML::BadFile& e) { ... }，漏掉catch就崩溃
读取嵌套结构时 node["a"]["b"]["c"].as<int>()</int> 崩溃？先判空再取值
yaml-cpp 的 operator[] 不做存在性检查，访问不存在的 key 会创建一个空节点（IsDefined() == false），此时调 .as<int>()</int> 抛 YAML::TypedBadConversion<int></int>。
立即学习“C++免费学习笔记（深入）”；
- 安全写法是链式判空：
if (node["server"] && node["server"]["port"]) { int port = node["server"]["port"].as<int>(); }</int> - 或用
node["server"]["port"].IsDefined()显式检查（注意不是IsNull()） - 对可选字段，用
node["timeout"].as<int>(30)</int>提供默认值，避免分支逻辑 - 数组访问同理：
node["hosts"][0]在数组为空时也创建空节点，务必先node["hosts"].size() > 0
写入 YAML 文件为什么缩进乱、顺序错、中文变乱码？
yaml-cpp 默认输出无缩进、键顺序按插入顺序（C++11 unordered_map 行为），且不处理 UTF-8 字符串的转义 —— 中文直接写入，但终端或编辑器编码不匹配就显示乱码。
- 控制缩进：用
YAML::Emitter替代直接 emitter 等，并设emitter.SetIndent(2) - 保证键顺序：不用
YAML::Node直接赋值，改用YAML::Node root = YAML::Load("{}"); root["a"] = 1; root["b"] = 2;（map 插入顺序保留） - 中文安全：确保源文件存为 UTF-8 无 BOM，且运行环境 locale 支持 UTF-8（Linux 下
LANG=en_US.UTF-8） - 避免意外转义：字符串含
:、[、{等字符时，yaml-cpp会自动加引号；如不想加，得用emitter
最易被忽略的是：YAML::Load() 对重复 key 的行为未定义，不同版本可能覆盖或报错，生产配置务必保证 key 唯一。
