setmapformat 不控制块/流模式，仅影响 std::map 序列化排序；真正控制格式的是 yaml::emitter 的 setmapformat() 和 setseqformat() 方法，参数为 yaml::flow 或 yaml::block。
YAML-CPP 中 SetMapFormat 不控制块/流模式
直接说结论：SetMapFormat 和块（block）/流（flow）模式完全无关。它只影响 std::map 类型的序列化行为（比如是否按 key 排序），对 YAML 的缩进风格、大括号/中括号是否换行、是否用 {} 或 [] 表示容器，统统不起作用。
真正控制块/流模式的是节点的 Emit 阶段所用的 Emitter 实例及其设置：
-
yaml-cpp没有全局“默认输出格式”开关 - 每个
YAML::Emitter对象可独立配置格式策略 - 关键方法是
emitter.SetSeqFormat()和emitter.SetMapFormat()—— 注意：这是Emitter的成员函数，不是Node的
emitter.SetSeqFormat() 与 emitter.SetMapFormat() 的实际效果
这两个函数决定容器在输出时是否强制走 flow（紧凑）风格。它们接受参数 YAML::Flow 或 YAML::Block：
YAML::Emitter emitter;
emitter.SetSeqFormat(YAML::Flow); // 所有 sequence 输出为 [a, b, c]
emitter.SetMapFormat(YAML::Flow); // 所有 map 输出为 {k1: v1, k2: v2}
// 若不调用，则默认为 Block 风格（换行 + 缩进）
注意点：
- 设置是 全局生效于该 emitter 实例，无法为单个节点单独指定
- 一旦设为
Flow，所有 map/seq 都会变紧凑，包括嵌套结构，可能降低可读性 - 若想混合使用（如顶层 block、内层 flow），只能手动构造
Emitter并分段写入（见下节）
如何实现“部分 block、部分 flow”的混合输出
没有内置 API 能让某个 Node 自动选择格式，但可通过 Emitter 的底层接口绕过自动序列化，手动控制输出节奏：
YAML::Emitter emitter; emitter <p>常见误操作：</p>
- 在
emitter 前调用 <code>SetMapFormat(YAML::Flow)，却期望只影响这个node—— 实际会影响后续所有 map - 试图对已构建好的
YAML::Node调用node.SetMapFormat(...)—— 该方法不存在，Node类没有这个接口 - 混淆
YAML::Flow（风格）和YAML::Literal（字符串样式），后者用于多行字符串，和结构格式无关
为什么 YAML::Emitter 不支持 per-node 格式控制
根本原因是 yaml-cpp 的设计哲学：序列化逻辑与数据分离。一个 Node 只存语义（键值对、类型、锚点等），不存呈现偏好；格式策略属于输出器（Emitter）职责。这带来两个现实影响：
- 若需精细控制（如 API 响应返回紧凑 JSON 风格 YAML，而日志 dump 用易读 block），必须准备多个
Emitter实例或重置其状态 - 不能通过修改
Node属性来“标记”某 map 应该 flow —— 没有对应字段或注解机制 - 第三方封装（如
yaml-cpp的 Rust 绑定或 Python 封装）有时会加一层格式 hint，但原生 C++ API 不提供
真正要落地混合格式，最终都得退回到手动 emit —— 这就是最容易被忽略的复杂点：你以为在配置 Node，其实是在调度 Emitter。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
