yaml-cpp不支持直接结构体绑定，需通过宏定义加特化实现operator>>和operator
YAML-CPP不支持直接结构体绑定，得靠宏+特化
YAML-CPP 本身没有像 serde_yaml 那样的自动派生机制，operator>> 和 operator 必须手动为每个结构体重载。所谓“自定义序列化宏”，本质是用预处理器生成这些重载函数的重复代码，避免手写冗余。不写宏也行，但字段一多就容易漏、难维护。
常见错误现象：undefined reference to `void YAML::convert<mystruct>::encode...</mystruct> 或解析时字段全为默认值——多半是没特化 YAML::convert<t></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；追求编译期确定性而非宏灵活性。
- 需包含
<boost></boost>和<boost></boost> - 适配后仍要显式特化
YAML::convert<mystruct></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<:string>() : "localhost";
rhs.port = node["port"] ? node["port"].as<int>() : 8080;
return true;
}
};
</int></:string></config>
-
node["key"]返回的是Node，空 key 会返回一个无效节点，用operator bool()判空最安全 - 不要用
node["key"].IsDefined()—— 它对缺失键也返回true（返回默认构造的Node） - 如果字段是
std::optional<t></t>，可以直接用node["key"].as<:optional>>()</:optional>（YAML-CPP ≥ 0.8）
宏展开后调试困难？加个 NO_OP 标签先验证结构
自定义宏一旦出错，报错位置往往在展开后的中间代码里，堆栈深、变量名乱。最有效的前置排查方式，是先用 YAML-CPP 自带的 Node::size() 和 Node::begin()/end() 打印原始结构，确认 YAML 键名、层级、类型是否符合预期。
例如加载后加一段验证逻辑：
YAML::Node config = YAML::LoadFile("config.yaml");
std::cout first.as<:string>()
<ul>
<li>YAML 中用了 <code>snake_case</code>，而结构体字段是 <code>camelCase</code>？宏不会自动转换，必须手动映射</li>
<li>数组字段被误写成对象（或反之），<code>node["list"].IsSequence()</code> 会返回 <code>false</code>，导致 decode 失败</li>
<li>浮点数精度丢失问题：YAML-CPP 默认用 <code>double</code> 解析，若需 <code>float</code>，必须显式调用 <code>as<float>()</float></code>
</li>
</ul>
<p>宏只是省事工具，真正决定健壮性的，是字段名一致性、类型可序列化性、以及缺失/异常情况的显式处理。别让宏掩盖了数据契约本身的模糊。</p></:string>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
