<p>YAML::LoadAll 解析不出多个文档主因是文档分隔符格式错误：必须严格使用独占一行、前后无空格的 ---，误写为 ----、# --- 或带空格的 --- 会导致后续文档被静默忽略。</p>
YAML::LoadAll 为什么解析不出多个文档？
直接调用 YAML::LoadAll 却只得到一个节点，大概率是因为输入字符串里文档分隔符格式不对。YAML 多文档必须用 --- 开头（前后无空格、单独一行），且不能跟在注释或缩进后；如果误写成 ----、# --- 或 ---（带空格），YAML::LoadAll 就会静默忽略后续文档，只返回第一个。
实操建议：
- 用
std::string原样拼接多文档时，确保每个---都独占一行，前后无空白字符 - 从文件读取后，先用
std::cout 打印原始内容，肉眼确认分隔符位置 - 若内容来自网络或用户输入，用
std::regex_replace清理首尾空白行再传入YAML::LoadAll
如何安全遍历 LoadAll 返回的 vector<Node>
YAML::LoadAll 返回 std::vector<YAML::Node>，但这个容器可能为空（比如空输入或全注释），也可能含无效节点（如解析失败的文档被跳过但不报错）。直接 at(0) 或 [i] 访问前必须检查 size。
常见错误现象：程序崩溃在 node["key"].as<int>()，实际是 node 本身为 null（node.IsNull() == true）。
立即学习“C++免费学习笔记（深入）”；
实操建议：
- 始终用
for (const auto& doc : docs)遍历，避免下标越界 - 每个
doc先调用if (!doc.IsMap() && !doc.IsSequence()) continue;过滤掉空或非法结构 - 提取字段前加
if (doc["version"]) { ... }判断键存在，而非直接doc["version"].as<std::string>()
LoadAll 和 Load 在内存与异常处理上的关键差异
YAML::Load 只解析第一个文档，遇到第二个 --- 就停；YAML::LoadAll 会扫描全文、尝试解析所有文档，失败的文档会被跳过（不抛异常），但整个调用仍可能因严重语法错误（如未闭合引号、嵌套错乱）抛 YAML::ParserException。
性能影响：对超大 YAML 文件（>10MB），LoadAll 比 Load 内存占用高 2–3 倍，因为它要缓存全部文档的 AST 节点。
实操建议：
- 明确只需要第一个文档时，别用
LoadAll—— 浪费内存且掩盖设计意图 - 捕获异常时，用
catch (const YAML::ParserException& e)，注意e.mark.line和e.msg才是真实错误位置 - 生产环境建议配合
YAML::LoadFile+try/catch，而非先读文件再调LoadAll，减少中间字符串拷贝
Windows 下中文路径或 UTF-8 BOM 导致 LoadAll 失败怎么办？
在 Windows 上用 YAML::LoadFile("配置.yaml") 调 LoadAll，若文件含 UTF-8 BOM（0xEF 0xBB 0xBF），libyaml 旧版本（YAML::BadFile；路径含中文时，std::ifstream 默认用本地编码（GBK），读出乱码后解析必然失败。
实操建议：
- 用 VS Code 或 Notepad++ 将文件另存为 “UTF-8 无 BOM” 格式
- 手动读文件时，用
std::wifstream+std::codecvt_utf8<wchar_t>转换，再转std::string - 更稳妥的做法：改用
YAML::Load逐段读取 —— 先按---分割字符串，再对每段调YAML::Load，完全绕过 BOM 和编码问题
多文档解析真正的复杂点不在 API 调用，而在于输入源的不可控性：BOM、换行符（CRLF/LF）、空格敏感性、以及 libyaml 对边缘 case 的静默处理。宁可多做一层字符串预处理，也不要依赖 LoadAll 自动容错。
