yaml-cpp默认不转义中文，中文显示为\u4f60\u597d或乱码的根源在于UTF-8流处理环节错误，而非转义开关；问题由源文件非UTF-8编码、Emitter输出未适配UTF-8、终端/编辑器解码错误三者共同导致。

yaml-cpp 默认不转义中文，所谓“禁止转义”其实是误判——真正的问题是输出乱码或被错误编码，根源在 UTF-8 流处理环节，而非转义开关。

为什么中文看起来像被转义了？

常见现象：YAML 输出里中文变成 \u4f60\u597d 或一堆问号/方块。这不是 yaml-cpp 主动转义，而是：
– 源文件保存为 GBK/ANSI（非 UTF-8），编译器读入后字节错乱；
– YAML::Emitter 输出时未确保底层 std::ostream 支持 UTF-8；
– 终端或编辑器用错误编码打开生成的 YAML 文件（如用 GBK 解析 UTF-8 字节流）。

yaml-cpp 本身对字符串不做 Unicode 转义：只要输入是合法 UTF-8 字节序列，它就原样写入，不插手 \uXXXX 编码。

确保中文原样输出的三步实操

必须同步满足以下三点，缺一不可：

立即学习“C++免费学习笔记（深入）”；

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• 源码字符串字面量用 UTF-8 编码保存（VSCode / CLion 默认即可；记事本需选“UTF-8 无 BOM”另存）
• 构造 YAML::Emitter 后，直接往它写入 UTF-8 字符串：

  YAML::Emitter emitter;
  emitter << YAML::BeginMap;
  emitter << YAML::Key << "name" << YAML::Value << "张三"; // ✅ 直接写中文，不要 std::string(u8"张三")
  emitter << YAML::EndMap;

• 把 emitter.c_str() 写入文件时，用二进制模式或确保流为 UTF-8：

  std::ofstream ofs("out.yaml", std::ios::binary); // 推荐：绕过文本模式换行/编码转换
  ofs << emitter.c_str();

  或使用 std::ofstream 配合 std::locale（复杂且易错，不推荐）

别碰的坑：set_unicode() 和自定义转义

YAML::Emitter::SetUnicode(true) 是个误导性接口——它只影响 YAML::EscapeNonAscii 这类内部标记，并不控制中文是否转义；设为 false 也不会阻止 UTF-8 原样输出，反而可能让 yaml-cpp 在某些边界场景 fallback 到 Latin-1 处理，加剧乱码。

更危险的是手动调用 emitter 或 <code>YAML::Literal 并试图包裹中文：这会强制加引号或换行块，但不会解决编码问题，还可能破坏 YAML 结构（如 | 块里混入非 UTF-8 字节时解析失败）。

验证输出是否真 UTF-8 的快速方法

生成 YAML 后，用命令行检查实际字节（Linux/macOS）：
file -i out.yaml → 应显示 charset=utf-8
xxd out.yaml | head → 中文“张三”应显示为连续 3 字节（如 e5 bc a0 e4 b8 89），而非 5c 75 4... （那是 \u 转义）

Windows 下可用 PowerShell：
Get-Content out.yaml -Encoding UTF8 不报错即大概率正确；若报“无法识别的字符”，说明文件本身不是 UTF-8。

最常被忽略的一点：yaml-cpp 不负责终端显示——它只管写出字节。你看到乱码，99% 是下游环节（文件保存路径、shell 环境、IDE 预览器）没对齐 UTF-8，而不是库配错了某个开关。