YAML::convert特化必须同时定义static encode和decode，且在全局或匹配命名空间；嵌套结构体和STL容器需确保元素类型已特化；字段名不一致需手动映射，缺失字段用IsDefined()判断，默认值在decode开头初始化；as<T>()可能抛异常，应先用Is<T>()或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> { ... }; }
YAML::convert 特化中如何处理嵌套结构体和 STL 容器
YAML-CPP 原生支持 std::vector、std::map、std::string 等，但对自定义类型不会自动递归展开。你需要显式调用 node["field"] << obj.field，此时若 field 是另一个已特化的结构体，它会自动复用对应 encode；同理 node["field"] >> obj.field 会触发其 decode。
注意容器元素类型也需可 YAML 序列化：比如 std::vector<MyStruct> 能工作，前提是 MyStruct 已完成 YAML::convert 特化。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 对
std::optional<T>，需手动判断node["field"]是否存在，再决定调用>>还是设为std::nullopt - 对
std::map<std::string, T>，直接用node["map_field"] >> obj.map_field即可，无需额外循环 - 避免把
std::shared_ptr<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"] << rhs.port; // 键名不同
node["server_host"] << rhs.host;
return node;
}
static bool decode(const Node& node, Config& rhs) {
if (!node.IsMap()) return false;
rhs = Config{}; // 先设默认值
if (node["server_port"].IsDefined())
rhs.port = node["server_port"].as<int>();
if (node["server_host"].IsDefined())
rhs.host = node["server_host"].as<std::string>();
return true;
}
};
为什么 as<T>() 在 decode 里可能抛异常，该怎么防
node.as<int>() 等隐式转换会在类型不匹配时抛 YAML::TypedBadConversion<int> 异常，而 decode 函数签名要求返回 bool，不能传播异常。正确做法是用 node.IsScalar() && node.Is<int>()</int> 预检，或改用带默认值的 node.as<int>(default_value)（但注意它仍会在类型强转失败时 fallback 到 default，不报错也不提示）。
- 对必填字段，建议先
if (!node["key"].IsDefined()) return false;，再if (!node["key"].Is<int>()) return false; - 对浮点字段，
node.Is<double>()不能识别整数 YAML 字面量（如42），应改用node.IsScalar() && node.as<double>()配合 try-catch（仅限 decode 内部临时捕获） - 字符串字段慎用
as<std::string>()：YAML 的null、true、false会被转成字符串字面量，不是你想要的空值
decode 函数里稳住 —— 少一个检查，线上就可能静默读错配置。 
