yaml-cpp 通过特化 yaml::convert 模板实现自定义类序列化，需在命名空间内定义 encode() 和 decode() 方法，不可重载 operator>。
用 yaml-cpp 库实现 C++ 对象树的序列化
直接结论：C++ 标准库不支持 YAML，必须借助第三方库；yaml-cpp 是目前最成熟、被广泛用于生产环境的选择。它支持写入（YAML::Emitter）和读取（YAML::Load），且能较好处理嵌套结构与自定义类型。
如何为自定义类重载 operator 实现序列化
yaml-cpp 不会自动识别你的类，必须显式告诉它“怎么把 MyClass 变成 YAML 节点”。核心是重载全局 operator，参数为 <code>YAML::Emitter& 和你的对象引用：
struct Person {
std::string name;
int age;
std::vector<:string> hobbies;
};
void operator 已有内置支持
out
<p>注意点：</p>
<ul>
<li>必须声明在全局命名空间，不能放在类内部或匿名命名空间</li>
<li>
<code>YAML::Emitter</code> 不是流式输出到文件，而是构建 YAML 文本缓冲区；最终用 <code>out.c_str()</code> 获取字符串再写入文件</li>
<li>嵌套对象（如 <code>std::vector<person></person></code>）也需对应重载——否则编译失败或运行时报 <code>bad_cast</code>
</li>
<li>如果成员含指针或非 POD 类型（如 <code>std::unique_ptr<t></t></code>），需手动解引用并递归序列化</li>
</ul>
<h3>写入文件时别漏掉 <code>std::ofstream</code> 的二进制标志和编码处理</h3>
<p>YAML 是纯文本格式，但 Windows 下若用默认 <code>std::ofstream</code> 打开，换行符可能被悄悄转成 <code>\r\n</code>，而 <code>yaml-cpp</code> 输出本身已含 <code>\n</code>；叠加后变成 <code>\r\r\n</code>，某些解析器会报错。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册（CHM版）"><img
src="https://img.php.cn/upload/manual/000/000/001/5d6de31fedca2993.png" alt="C函数速查手册（CHM版）" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册（CHM版）" class="overflowclass">C函数速查手册（CHM版）</a>
<p class="overflowclass">C函数速查手册（CHM版）</p>
</div>
<a rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册（CHM版）" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<p>正确做法：</p>
<ul>
<li>用 <code>std::ofstream file("out.yaml", std::ios::out | std::ios::binary)</code> 显式指定 binary 模式</li>
<li>写入前调用 <code>file.imbue(std::locale::classic())</code> 避免本地化数字/时间格式干扰</li>
<li>不要直接 <code>file —— <code>c_str()</code> 返回的是 <code>const char*</code>，但 <code>emitter</code> 内部缓冲区可能含空字节（极少见）；稳妥方式是：<code>file.write(emitter.c_str(), emitter.size())</code></code>
</li>
</ul>
<h3>遇到 <code>YAML::InvalidNode</code> 或空输出？先检查节点构造顺序</h3>
<p>常见错误现象：生成的 YAML 文件为空，或只有一行 <code>~</code>，或抛出 <code>YAML::InvalidNode</code> 异常。根本原因通常是节点未按 YAML 语法闭合，比如：</p>
<ul>
<li>写了 <code>YAML::BeginMap</code> 却漏了 <code>YAML::EndMap</code>
</li>
<li>在 map 中写 key 后没跟 <code>YAML::Value</code> 就直接写值（<code>out 是错的）</code>
</li>
<li>对空容器（如空 <code>std::vector</code>）未显式处理，导致 <code>YAML::Emitter</code> 在 map 中悬空一个 key</li>
<li>使用 <code>YAML::Node</code> 构建中间结构时，误将临时 <code>Node</code> 绑定到引用（<code>const YAML::Node& n = node["x"];</code>），后续 <code>node</code> 被销毁后 <code>n</code> 成悬垂引用</li>
</ul>
<p>调试建议：在序列化函数末尾加一句 <code>assert(out.good());</code>，并在写入前打印 <code>emitter.size()</code> 确认缓冲区非零。</p>
<p>复杂点在于——树形结构中父子关系需靠构造顺序隐式表达，没有显式“parent”字段；一旦某层重载逻辑出错，整个子树就塌陷，且错误位置往往不在报错行，而在上游某个未闭合的 <code>BeginXXX</code>。</p></:string>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
