YAML-CPP不支持直接结构体绑定，需通过宏定义加特化实现operator>>和operator<<的重载。
YAML-CPP不支持直接结构体绑定，得靠宏+特化
YAML-CPP 本身没有像 serde_yaml 那样的自动派生机制，operator>> 和 operator 必须手动为每个结构体重载。所谓“自定义序列化宏”，本质是用预处理器生成这些重载函数的重复代码，避免手写冗余。不写宏也行，但字段一多就容易漏、难维护。
常见错误现象：undefined reference to `void YAML::convert<MyStruct>::encode... 或解析时字段全为默认值——多半是没特化 YAML::convert<T>，或特化没在头文件里、没加 inline。
- 宏必须定义在头文件中（否则链接时报错），且通常搭配
YAML_CONVERT_SPECIALIZE这类命名约定 - 所有字段名必须与 YAML 键名严格一致（区分大小写），且类型需能被 YAML-CPP 原生支持或已特化过
- 嵌套结构体字段需先确保其自身已特化
YAML::convert，否则编译失败
用 BOOST_FUSION_ADAPT_STRUCT 实现零运行时开销绑定
如果你用的是较老版本 YAML-CPP（BOOST_FUSION_ADAPT_STRUCT 是更稳妥的选择。它把结构体“暴露”给 Boost.Fusion，再配合 YAML-CPP 的 convert 模板推导，自动生成序列化逻辑。
使用场景：结构体字段稳定、不频繁增删；项目已引入 Boost；追求编译期确定性而非宏灵活性。
立即学习“C++免费学习笔记（深入）”；
- 需包含
<boost/fusion/include/adapt_struct.hpp>和<boost/fusion/include/io.hpp> - 适配后仍要显式特化
YAML::convert<MyStruct>，但内部可直接用boost::fusion::for_each遍历字段 - 不支持 bitfield、static 成员、私有字段（除非加友元），也不处理访问控制逻辑
字段缺失时默认值怎么设？别依赖构造函数
YAML-CPP 解析时，若某字段在 YAML 中不存在，默认会调用该字段类型的默认构造函数（如 int 变成 0，std::string 变为空）。但你不能指望结构体构造函数来兜底——因为 convert::decode() 创建的是临时对象再赋值，构造函数早执行完了。
正确做法是在 decode() 特化里显式检查节点是否存在，并赋予默认值：
template <>
struct convert<Config> {
static Node encode(const Config& rhs) {
Node node;
node["host"] = rhs.host;
node["port"] = rhs.port;
return node;
}
static bool decode(const Node& node, Config& rhs) {
if (!node.IsMap()) return false;
rhs.host = node["host"] ? node["host"].as<std::string>() : "localhost";
rhs.port = node["port"] ? node["port"].as<int>() : 8080;
return true;
}
};
-
node["key"]返回的是Node，空 key 会返回一个无效节点，用operator bool()判空最安全 - 不要用
node["key"].IsDefined()—— 它对缺失键也返回true（返回默认构造的Node） - 如果字段是
std::optional<T>，可以直接用node["key"].as<std::optional<T>>()（YAML-CPP ≥ 0.8）
宏展开后调试困难？加个 NO_OP 标签先验证结构
自定义宏一旦出错，报错位置往往在展开后的中间代码里，堆栈深、变量名乱。最有效的前置排查方式，是先用 YAML-CPP 自带的 Node::size() 和 Node::begin()/end() 打印原始结构，确认 YAML 键名、层级、类型是否符合预期。
例如加载后加一段验证逻辑：
YAML::Node config = YAML::LoadFile("config.yaml");
std::cout << "Keys: ";
for (auto it = config.begin(); it != config.end(); ++it) {
std::cout << it->first.as<std::string>() << " ";
}
- YAML 中用了
snake_case，而结构体字段是camelCase？宏不会自动转换，必须手动映射 - 数组字段被误写成对象（或反之），
node["list"].IsSequence()会返回false，导致 decode 失败 - 浮点数精度丢失问题：YAML-CPP 默认用
double解析，若需float，必须显式调用as<float>()
宏只是省事工具，真正决定健壮性的，是字段名一致性、类型可序列化性、以及缺失/异常情况的显式处理。别让宏掩盖了数据契约本身的模糊。
