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 编码。
确保中文原样输出的三步实操
必须同步满足以下三点，缺一不可：
- 源码字符串字面量用 UTF-8 编码保存（VSCode / CLion 默认即可；记事本需选“UTF-8 无 BOM”另存）
- 构造
YAML::Emitter后，直接往它写入 UTF-8 字符串：YAML::Emitter emitter; emitter
- 把
emitter.c_str()写入文件时，用二进制模式或确保流为 UTF-8：std::ofstream ofs("out.yaml", std::ios::binary); // 推荐：绕过文本模式换行/编码转换 ofs 或使用 <code>std::ofstream</code> 配合 <code>std::locale</code>（复杂且易错，不推荐）
别碰的坑：set_unicode() 和自定义转义
YAML::Emitter::SetUnicode(true) 是个误导性接口——它只影响 YAML::EscapeNonAscii 这类内部标记，并不控制中文是否转义；设为 false 也不会阻止 UTF-8 原样输出，反而可能让 yaml-cpp 在某些边界场景 fallback 到 Latin-1 处理，加剧乱码。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
更危险的是手动调用 emitter 或 <code>YAML::Literal 并试图包裹中文：这会强制加引号或换行块，但不会解决编码问题，还可能破坏 YAML 结构（如 | 块里混入非 UTF-8 字节时解析失败）。
验证输出是否真 UTF-8 的快速方法
生成 YAML 后，用命令行检查实际字节（Linux/macOS）：file -i out.yaml → 应显示 charset=utf-8xxd 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，而不是库配错了某个开关。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
