YAML::Emitter 必须实例化后通过流式操作写入内容，无静态方法如 YAML::Emitter::Emit()；它是一个状态机对象，不支持直接静态调用。
YAML::Emitter 不是静态类，不能直接调用静态方法生成模板；它必须实例化后通过流式操作写入内容，否则会编译失败或输出乱码。
YAML::Emitter 必须实例化才能用，不存在 YAML::Emitter::Emit() 这类静态接口
很多人搜“YAML Emitter static method”，是误以为像 jsoncpp 的 Json::StreamWriterBuilder 那样有静态构建入口。但 yaml-cpp 的 YAML::Emitter 是一个状态机对象，所有写入操作（operator、<code>BeginMap() 等）都依赖内部缓冲区和缩进栈——没实例就没状态。
- 错误写法：
YAML::Emitter::Emit(...)→ 编译报错：no member named 'Emit' in 'YAML::Emitter' - 正确姿势：声明变量
YAML::Emitter emitter;，再逐行写入 - 注意：
emitter不能跨作用域复用（比如函数返回局部YAML::Emitter），因为其内部缓冲区在析构时才 flush
生成配置模板的典型写法：用 BeginMap()/BeginSeq() 搭配流式插入
想快速输出带注释、缩进、默认值的 YAML 模板（如数据库配置、日志级别等），核心是控制结构层级 + 插入 YAML::Comment()。不需要手拼字符串，也不推荐先构造 YAML::Node 再 dump——那适合已有数据，而模板更强调“结构先行”。
- 用
emitter 开启根映射，每对 <code>key: value用emitter - 加注释必须在对应键前调用
emitter - 嵌套结构靠
BeginMap/EndMap或BeginSeq/EndSeq成对出现，缩进自动处理 - 示例片段：
YAML::Emitter emitter; emitter << YAML::BeginMap << YAML::Comment("数据库连接配置") << YAML::Key << "database" << YAML::Value << YAML::BeginMap << YAML::Key << "host" << YAML::Value << "localhost" << YAML::Key << "port" << YAML::Value << 5432 << YAML::Key << "timeout_ms" << YAML::Value << 5000 << YAML::EndMap << YAML::Key << "log_level" << YAML::Value << "info" << YAML::EndMap;
常见坑：中文注释乱码、空格缩进失效、bool 值被转成 true/false 而非 on/off
模板里写中文注释或希望兼容 Ansible/Shell 工具时，输出格式容易出问题：
立即学习“C++免费学习笔记（深入）”；
- 中文注释乱码：确保源文件保存为 UTF-8 无 BOM，且编译器（如 GCC/Clang）未强制指定
-fexec-charset=GBK；yaml-cpp本身不转码，原样输出字节 - 缩进不是 2 空格：默认是 2，但若中间混用
operator 和 <code>BeginMap顺序错乱（比如漏掉EndMap），会导致后续行缩进崩塌 - bool 输出为
true/false：这是 YAML 1.2 规范行为，无法用Emitter改成on/off；如需兼容旧工具，得手动写字符串"on"而非true - 浮点数精度丢失：
emitter 可能输出 <code>3.1415926或科学计数法，取决于编译器 float 输出策略；固定精度请先格式化为std::string再写入
性能与线程安全：模板生成无需锁，但别在多线程里共用同一个 YAML::Emitter 实例
单次模板生成（几百行内）耗时在微秒级，YAML::Emitter 内部无系统调用，纯内存操作。但它不是线程安全的——内部有 std::stringstream 成员和状态标记位，多个线程同时调用 operator 会破坏缓冲区。
- 安全做法：每个线程创建独立
YAML::Emitter，或用局部变量（函数内声明） - 避免全局/静态
YAML::Emitter对象，哪怕只读也不行——operator 会修改其内部状态 - 如果要反复生成同类模板（如不同服务名），建议封装成函数，每次 new 一个
emitter，别试图“重置”它
真正卡住人的往往不是语法，而是忘了 YAML::Emitter 是个带状态的流式写入器——它不像 printf 那样无状态可重入，也不像 std::ostringstream 那样能 clear() 后复用。结构没闭合、注释位置错、跨线程共享，这三处一出问题，输出就不可预测。
