YAML引号仅作字面量修饰符，解析后不保留；单引号支持''转义，双引号支持\n等转义；无引号值可能被误判为bool/int；强制字符串需加引号或显式类型标注。

YAML单引号和双引号字符串在C++中会被libyaml或yaml-cpp自动解码

用 yaml-cpp 解析时，'hello' 和 "hello" 都会变成纯字符串 hello，引号本身不会保留在值里。这是 YAML 规范定义的行为，不是库的 bug —— 引号只是字面量修饰符，不是内容的一部分。

常见错误现象：你写 name: "O'Reilly"，解析后得到 O'Reilly（带单引号），但误以为引号是原始字符串的一部分，结果做字符串比较或拼接时出错。

• 单引号字符串：'It''s fine' → 解析为 It's fine（两个连续单引号转义为一个）
• 双引号字符串："Line 1\nLine 2" → 解析为含换行符的字符串（\n 被解释）
• 无引号字符串：yes、off、123 可能被识别为 bool 或 int，而非 string

如何强制把带引号的原始文本当字符串读（绕过自动类型推断）

YAML 解析器默认按内容推测类型，yes 会被当成 true，123 当成 int。若你明确要字符串，必须显式标注类型或加引号。

实操建议：

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

C++ Code Review Master

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

下载

• 所有预期为字符串的字段，**统一用双引号包裹**（更安全，支持转义）
• 若字段值可能匹配 YAML 内置类型（如 on, no, null, 1.23e4），必须加引号，否则 yaml-cpp 的 as<:string>()</:string> 会失败或返回空
• 不要依赖 IsScalar() + as<:string>()</:string> 硬转：对 123（未加引号），as<:string>()</:string> 抛 YAML::BadConversion
• 稳妥做法是先用 as<:string>()</:string>，捕获异常；失败时尝试 as<int>()</int> / as<bool>()</bool>，再手动转字符串（仅限业务允许的场景）

yaml-cpp 中获取原始未解析字符串值（不推荐但有时需要）

yaml-cpp 不提供“原始 token”访问接口，它只暴露解析后的 AST 节点。所谓“原始字符串”，其实是 YAML parser 在 lexical 阶段就处理掉了引号和转义 —— 你拿不到 "a\"b" 这个字面量，只能拿到 a"b。

如果你真需要保留引号格式（比如做配置文件 diff 或格式化重写），有两个现实路径：

• 改用基于 lexer 的解析器（如 libyaml 的 yaml_parser_scan()），自己维护 token 流，代价高、易出错
• 预处理 YAML 文本：用正则匹配 key:\s*["'].*?["'] 提取带引号的右值（注意嵌套引号和跨行问题，不可靠）
• 接受事实：YAML 是数据序列化格式，不是文本模板。设计上就不鼓励“读原始引号”

常见引号相关错误与调试技巧

遇到解析结果不符合预期，先确认是不是引号导致的类型误判或转义问题。

快速验证步骤：

• 用 yaml-cpp 的 operator 打印整个节点：<code>std::cout ，看输出是否含引号 —— 输出带引号只是调试格式，不代表值里有引号
• 检查 node.Type()：是 YAML::NodeType::Scalar 才能调 as<T>()；如果是 Null 或 Undefined，说明 key 不存在或值为空
• 对疑似布尔/数字的字符串字段，加日志打印 node.Scalar()（返回原始解析后字符串）和 node.IsDefined()
• 用在线 YAML parser（如 yamlchecker.com）粘贴你的片段，确认语法是否被正确理解

最常被忽略的一点：YAML 的缩进是语义的一部分，单引号/双引号解决不了缩进错误。哪怕引号全对，多一个空格也可能让 name 变成子项而不是同级字段。