yaml::convert特化必须同时定义static encode和decode，且在全局或匹配命名空间；嵌套结构体和stl容器需确保元素类型已特化；字段名不一致需手动映射，缺失字段用isdefined()判断，默认值在decode开头初始化；as()可能抛异常，应先用is()或isscalar()预检。
为什么直接用 YAML::convert 特化会编译失败
常见错误是只特化了 encode 或 decode 中的一个，而 YAML::convert 要求两者必须同时存在。编译器看到结构体被用于 YAML::Load 或 YAML::Dump 时，会尝试实例化完整特化，缺任一函数就报 “no member named ‘encode’” 或类似 SFINAE 失败错误。
另一个典型坑是忘记加 static 修饰符 —— encode 和 decode 必须是 static 成员函数，否则链接期或模板推导会出问题。
- 特化必须在全局命名空间（或与目标结构体同名空间），不能在函数内或匿名命名空间
- 若结构体含私有成员，
decode中需用友元或提供 public setter，不能直接赋值 - 特化模板必须完全匹配：比如结构体在
ns::A，特化也得写namespace ns { template struct convert<a> { ... }; }</a>
YAML::convert 特化中如何处理嵌套结构体和 STL 容器
YAML-CPP 原生支持 std::vector、std::map、std::string 等，但对自定义类型不会自动递归展开。你需要显式调用 node["field"] ，此时若 <code>field 是另一个已特化的结构体，它会自动复用对应 encode；同理 node["field"] >> obj.field 会触发其 decode。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
注意容器元素类型也需可 YAML 序列化：比如 std::vector<mystruct></mystruct> 能工作，前提是 MyStruct 已完成 YAML::convert 特化。
- 对
std::optional<t></t>，需手动判断node["field"]是否存在，再决定调用>>还是设为std::nullopt - 对
std::map<:string t></:string>，直接用node["map_field"] >> obj.map_field即可，无需额外循环 - 避免把
std::shared_ptr<t></t>直接塞进 YAML —— 应操作其*ptr，否则会序列化指针地址（无意义）
字段名不一致、默认值、缺失字段容错怎么写
YAML 键名和 C++ 成员名不一致时，不能靠重命名变量，只能在 encode/decode 中显式映射。缺失字段的容错靠 node["key"] 返回的 Node 是否 IsDefined() 判断；默认值则在 decode 开头初始化结构体，再按需覆盖。
struct Config {
int port = 8080;
std::string host = "localhost";
};
template
struct YAML::convert<config> {
static Node encode(const Config& rhs) {
Node node;
node["server_port"] ();
if (node["server_host"].IsDefined())
rhs.host = node["server_host"].as<:string>();
return true;
}
};</:string></config>
为什么 as<t>()</t> 在 decode 里可能抛异常，该怎么防
node.as<int>()</int> 等隐式转换会在类型不匹配时抛 YAML::TypedBadConversion<int></int> 异常，而 decode 函数签名要求返回 bool，不能传播异常。正确做法是用 node.IsScalar() && node.Is<int>()</int> 预检，或改用带默认值的 node.as<int>(default_value)</int>（但注意它仍会在类型强转失败时 fallback 到 default，不报错也不提示）。
- 对必填字段，建议先
if (!node["key"].IsDefined()) return false;，再if (!node["key"].Is<int>()) return false;</int> - 对浮点字段，
node.Is<double>()</double>不能识别整数 YAML 字面量（如42），应改用node.IsScalar() && node.as<double>() </double>配合 try-catch（仅限 decode 内部临时捕获） - 字符串字段慎用
as<:string>()</:string>：YAML 的null、true、false会被转成字符串字面量，不是你想要的空值
decode 函数里稳住 —— 少一个检查，线上就可能静默读错配置。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
