YAML多行字符串在C++中读取失败主因是未处理|与>的换行差异及UTF-8 BOM；yaml-cpp统一裁剪首尾空白，但|保留行尾空格而>丢弃并压缩空行；Windows需手动跳过BOM；IsScalar()无法区分单/多行，须查\n或正则匹配符号。
YAML 多行字符串在 C++ 中读取失败，90% 是因为没处理好字面量（|）和折叠（>）符号的换行行为差异，libyaml 或 yaml-cpp 默认不会保留原始缩进或合并空行 —— 你得手动控制解析策略。
yaml-cpp 中 | 和 > 的实际解析结果差异
yaml-cpp 不区分字面量与折叠语义，统一按“保留换行但裁剪首尾空白”处理，但关键区别在于：用 | 时，每行末尾的空格会被保留；用 > 时，行尾空格被丢弃，且连续空行会被压缩成单个 \n。
-
|：所有换行、缩进、行尾空格原样保留（除开头/结尾的空白块） -
>：换行转为空格，除非行首有+或-修饰符；空行被忽略 - yaml-cpp 的
as<:string>()</:string>会自动 trim 首尾空白，但不会还原被>合并掉的换行
读取多行字符串时必须设置 YAML::LoadFile() 的编码与 BOM 处理
Windows 下用记事本保存的 YAML 文件常带 UTF-8 BOM，yaml-cpp 2.0+ 版本默认不跳过 BOM，会导致首个节点解析失败或字符串开头出现乱码（如 "\xEF\xBB\xBFkey: value"）。
- 用
std::ifstream手动打开文件，调用.imbue(std::locale(std::locale(), new std::codecvt_utf8<char>))</char>（C++11 及以上） - 或更稳妥：用
std::filesystem::read_symlink+std::string_view预处理，跳过前 3 字节（\xEF\xBB\xBF）再传给YAML::Load() - Linux/macOS 一般无此问题，但跨平台项目务必统一检查
YAML::Node::IsScalar() 无法识别多行字符串类型？
yaml-cpp 把所有字符串（含多行）都归为 scalar 类型，IsScalar() 返回 true 并不能说明它是多行 —— 你需要靠内容特征判断：
立即学习“C++免费学习笔记（深入）”；
- 检查字符串中是否包含
\n（注意：>折叠后可能没有\n） - 若原始 YAML 明确用了
|，可在加载前用正则匹配该 key 对应的行（如R"(key:\s*\|)"） - 避免依赖
Mark().line定位，因为 libyaml 解析后行号信息不可靠
安全提取多行字符串的推荐写法（yaml-cpp v0.8+）
别直接 node["key"].as<:string>()</:string>，改用显式转换并校验换行存在性：
std::string get_multiline_string(const YAML::Node& node, const std::string& key) {
if (!node[key] || !node[key].IsScalar()) return "";
std::string s = node[key].as<std::string>();
// 若原始是 > 且你期望保留逻辑段落，需额外 split("\n") 再 join(" ")
if (s.find('\n') == std::string::npos && node[key].Mark().column > 0) {
// 可能是折叠字符串，尝试用原始解析器重载（见 yaml-cpp issue #1076）
}
return s;
}
真正复杂场景（如文档含混合 |/>、嵌套缩进、注释内换行），建议放弃纯 C++ 解析，改用 Python 的 pyyaml 导出为 JSON 后再读入 —— YAML 的人类可读性设计，本就不是为 C++ 直接消费优化的。
