缩进失效是因为YAML::Dump(my_map)扁平化嵌套map，不保留结构；须用YAML::Node逐层赋值（如root"a"["c"]=val）构建映射树，配合emitter.SetIndent(2)控制缩进。
用 yaml-cpp 序列化嵌套 std::map 时为什么缩进失效？
直接调用 YAML::Dump() 导出 std::map 默认不保留嵌套结构的语义，它会把多层嵌套的 std::map 扁平展开为单层键值对（尤其当键是字符串、值是混合类型时），根本不会生成缩进。真正起作用的是「节点类型」和「插入顺序」：必须显式构造 YAML::Node 并用 operator[] 逐层赋值，让 yaml-cpp 推断出映射（Map）而非序列（Sequence）结构。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 不要用
YAML::Dump(my_map)—— 这仅适用于简单同构 map（所有 value 都是基本类型且无嵌套） - 改用
YAML::Node root;+ 多层root["a"]["b"]["c"] = value;构建树形结构 - 若 map 的 value 是
std::map<std::string, std::any>或变体类型，需手动switch类型分支并调用对应node[...].SetType(...) - 注意：
std::map插入顺序即 YAML 键顺序，但 yaml-cpp 1.10+ 默认按字典序输出键——加YAML::Emitter emitter;并设emitter.SetIndent(2); emitter 才能控制缩进宽度
导出含 vector/list 嵌套的 map 时如何避免被转成 inline 格式？
yaml-cpp 对 std::vector 默认使用 flow-style（如 [1, 2, 3]），破坏可读性。嵌套在 map 中时更易触发 inline 行为，尤其当 vector 元素本身是 map 或复杂对象。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 对 vector 类型节点，显式调用
node.SetStyle(YAML::EmitterStyle::Block) - 若 vector 存的是自定义 struct，先将其转为
YAML::Node再 push_back，而非直接赋值 - 避免混用
node["list"].push_back(...)和node["list"][i] = ...—— 后者可能触发隐式序列创建并丢失 block 风格 - 示例：
YAML::Node list_node; list_node.SetStyle(YAML::EmitterStyle::Block); for (const auto& item : my_vector) { list_node.push_back(to_yaml_node(item)); // 自定义转换函数 } root["items"] = list_node;
中文 key 或 value 出现乱码或被引号包裹？
yaml-cpp 默认使用 UTF-8 编码，但若源字符串实际是 GBK/UTF-16，或编译器未启用 UTF-8 源文件支持，会导致输出乱码；而含空格、冒号、短横线等字符的 key/value 会被自动加双引号——这不是 bug，是 YAML 规范要求，但影响配置可读性。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确保 C++ 字符串字面量是 UTF-8 编码（VS 需加
// @charset "utf-8";，Clang/GCC 加-finput-charset=utf-8） - 避免用非 ASCII 字符作 key（如
root["数据库地址"]），改用英文 key + 注释说明 - 若必须保留中文 value，用
emitter.SetStringFormat(YAML::StringFormat::Plain)可禁用引号，但需自行保证内容不违反 YAML 语法（不能含:、#、开头空格等） - 写入文件时，用
std::ofstream f("config.yaml", std::ios::out | std::ios::binary);避免 Windows 下自动换行干扰 UTF-8 BOM 判断
性能敏感场景下反复构建 YAML::Node 是否开销过大？
每次调用 root["a"]["b"] = value 都会触发内部节点查找与拷贝，对千级嵌套 map 或高频导出（如配置热重载）会造成明显延迟。yaml-cpp 的 Node 不是轻量引用，而是带引用计数的句柄。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 预分配深度路径节点：用
YAML::Node a = root["a"]; YAML::Node b = a["b"];避免重复解析路径 - 对固定结构配置，手写模板字符串 +
std::format（C++20）或fmt::format替代 yaml-cpp，快 5–10 倍 - 若必须用 yaml-cpp 且结构稳定，封装一层缓存：将
std::map<std::string, YAML::Node>映射到已构建好的子节点，复用而非重建 - 调试时加
YAML::Node::Reset();清理全局缓存（极少数情况内存泄漏会卡住后续 Dump）
嵌套 YAML 导出真正的难点不在语法，而在你是否清楚每个 operator[] 调用背后触发了几次节点查找、是否意识到 SetStyle 必须在赋值后立即设置、以及中文字符在不同编译器下的编码链路断裂点——这些地方一错，输出就不可控。
