YAML::LoadFile直接返回根节点YAML::Node，无需额外获取；其类型为Map、Sequence或Scalar，需用IsDefined()检查存在性并用as<T>()前确保类型匹配，否则抛异常。
YAML::LoadFile 返回的是 YAML::Node，它本身就是根节点 —— 不需要额外“获取根节点”，直接用就行。
YAML::LoadFile 返回值就是根节点，不是容器或包装器
很多人误以为 YAML::LoadFile 返回一个“文件对象”或“文档句柄”，得再调用某个方法取根。其实它直接解析并返回顶层 YAML::Node，该节点对应 YAML 文件最外层结构（可能是 Map、Sequence 或标量）。
- 如果 YAML 文件是
name: Alice，返回的YAML::Node类型为YAML::NodeType::Map - 如果是
- a\n- b，类型为YAML::NodeType::Sequence - 如果是纯字符串
hello，类型为YAML::NodeType::Scalar
验证方式：打印 node.Type() 或用 node.IsMap() / node.IsSequence() / node.IsScalar() 判断。
常见错误：对空文件或路径错误的 node 直接访问字段
若文件不存在、权限不足、格式非法，YAML::LoadFile 会抛出 YAML::ParserException 或 YAML::BadFile，不会返回空节点。但有人忽略异常，直接写 node["key"]，导致程序崩溃。
立即学习“C++免费学习笔记（深入）”；
- 务必用
try { ... } catch (const YAML::Exception& e) { ... }包裹YAML::LoadFile - 不要依赖
node.IsNull()来判断加载是否成功 —— 加载失败时根本不会返回有效YAML::Node - 检查节点是否存在某 key，用
node["key"]后先调node["key"].IsDefined()，而不是直接.as<int>()
访问子节点时注意类型匹配和边界
YAML::Node 是类型擦除的，取值时必须确保目标类型与 YAML 中实际类型一致，否则抛 YAML::BadConversion。
-
node["port"].as<int>()要求该字段是整数（42或0x2A），不能是字符串"42"（除非启用了隐式转换，但不推荐） - 访问数组元素前，先用
node.size()或node.IsSequence()确认类型，再用node[i]；越界不报错，但行为未定义 - 嵌套访问如
node["server"]["host"]，中间任意一级未定义都会使最终结果.IsDefined() == false
示例安全写法：
YAML::Node config = YAML::LoadFile("config.yaml");
if (!config["database"]["port"].IsDefined()) {
throw std::runtime_error("missing database.port");
}
int port = config["database"]["port"].as<int>();真正容易被忽略的点：YAML 解析默认不启用字符串自动转数字（比如把 "123" 当成 int），也不做类型推导回退。你写的 .as<int>() 必须和原始 YAML 的节点类型严格匹配，否则就崩 —— 这和 JSON 库的行为很不同。
