YAML::convert未定义导致vector序列化编译失败，需在YAML命名空间中特化模板实现encode/decode，确保元素类型可序列化，嵌套容器自动递归支持，大vector建议用Emitter或手写避免性能损耗。
vector序列化失败：YAML::convert未定义时的编译错误
直接对std::vector调用YAML::dump会报错：no matching function for call to ‘convert’。因为YAML::convert是特化模板，STL容器默认不支持，必须显式提供转换规则。
常见错误现象：编译卡在YAML::Node node = YAML::Dump(vec);，提示找不到YAML::convert<:vector>></:vector>的实例化版本。
- 不能依赖ADL自动查找，必须在
YAML命名空间内特化convert模板 - 特化必须在头文件中完成（或确保被包含前已声明），否则链接期可能静默失败
- 若
T本身不可序列化（如含指针、非POD成员），特化后仍会编译失败
正确特化YAML::convert>的写法
核心是在YAML命名空间中为具体vector类型提供encode和decode实现。以std::vector<int></int>为例：
namespace YAML {
template<typename T>
struct convert<std::vector<T>> {
static Node encode(const std::vector<T>& rhs) {
Node node;
for (const auto& v : rhs) node.push_back(v);
return node;
}
static bool decode(const Node& node, std::vector<T>& rhs) {
if (!node.IsSequence()) return false;
rhs.clear();
for (size_t i = 0; i < node.size(); ++i) {
T val;
if (decode(node[i], val)) rhs.push_back(val);
else return false;
}
return true;
}
};
}注意：push_back会自动调用T类型的encode，所以T也需可序列化（如int、std::string、或你自定义的convert特化）。
立即学习“C++免费学习笔记（深入）”；
- 不要在
encode里用node["key"] = value——这是映射写法，vector对应YAML序列（-开头） -
decode中必须检查node.IsSequence()，否则从非序列节点反序列化会崩溃 - 若需支持
const vector&参数，模板参数应为const std::vector<T>&，但标准写法用非const引用更通用
嵌套vector（如vector>）需要递归支持
YAML::convert特化是类型精确匹配的。vector<vector<string>>不会复用vector<string>的特化，必须确保所有嵌套层级的元素类型都已提供convert定义。
例如，若已定义convert<std::string>（内置支持）和convert<std::vector<std::string>>，则vector<vector<string>>可直接用——因为encode中node.push_back(v)里的v是vector<string>，会触发其特化。
- 不需要为每层嵌套单独写特化，只要最内层类型（如
string）和中间容器（如vector<string>）都支持即可 - 若中间层是自定义结构体，必须为其单独特化
convert，否则push_back无法展开 - 深度嵌套时，
decode中的循环嵌套易出错，建议用递归辅助函数分离逻辑
性能与兼容性陷阱：vector很大时别用YAML::dump反复构造Node
YAML::dump底层会构建完整Node树再序列化成字符串，对大vector（如10万+元素）会产生显著内存和CPU开销。且Node拷贝是深拷贝，频繁调用push_back会多次重分配内部存储。
- 生产环境建议：先用
std::ostringstream手写YAML序列（如"- "+ value +"\n"），绕过Node抽象层 - 调试阶段可用
YAML::Emitter流式输出，避免中间Node对象：emitter << YAML::BeginSeq; for(...) emitter << item; emitter << YAML::EndSeq; - 旧版
yaml-cpp（Emitter流式写入，必须升级到3.x或4.x
真正麻烦的是混合类型容器（如vector<std::any>）或运行时才确定元素类型的场景——这时convert模板特化机制完全失效，得换用反射或手动映射。
