YAML::Node::IsNull() 仅对显式 null 字面量（如~、null、""等）返回 true；节点未定义时调用它会返回 false，但应先用 IsDefined() 检查存在性，再用 IsNull() 判断是否显式为 null，最后才安全调用 as()。
YAML::Node::IsNull() 返回 false 却实际是 null？
直接结论：YAML::Node::IsNull() 仅在节点**明确为 YAML 的 null 字面量（如 ~、null、Null、NULL、空字符串 ""）时才返回 true；若节点根本未定义（比如 key 不存在），它不是 null，而是“不存在”，此时调用 IsNull() 会返回 false，但更关键的是——你甚至不该对一个不存在的节点调用它。
常见错误现象：config["timeout"].IsNull() 返回 false，你以为有值，结果后续 as<int>()</int> 崩溃或读出 0 —— 实际是因为 timeout 这个 key 根本没出现在 YAML 文件里，config["timeout"] 是一个 default-constructed 的空 YAML::Node，它既不是 null，也不是 int，什么类型都不是。
- 先用
config["timeout"].IsDefined()判断 key 是否存在 - 再用
config["timeout"].IsNull()判断是否显式设为 null - 二者都通过后，才能安全调用
as<int>()</int>或其他转换
YAML 中哪些写法会被 IsNull() 识别为 true
YAML::Node::IsNull() 对以下 YAML 写法返回 true：
port: ~ host: null debug: Null enabled: NULL name: ""
注意：空格、大小写、引号不影响识别（libyaml-cpp 2.0+ 已统一处理）。但以下写法 不会 触发 IsNull()：
立即学习“C++免费学习笔记（深入）”；
-
port:（冒号后无任何内容，包括换行）→ 这是语法错误，解析失败，根本得不到YAML::Node -
port:（冒号后跟空格）→ 解析为""（空字符串），IsNull()返回true✅ -
port: 0→ 是整数 0，IsNull()返回false -
port: "0"→ 是字符串 "0"，IsNull()返回false
读取可选字段时的标准三段式检查
生产环境最常踩的坑，就是把“字段缺失”和“字段为 null”混为一谈。正确做法是严格分三步：
-
if (!config["timeout"].IsDefined())→ 字段没写，走默认逻辑（如设为 30） -
else if (config["timeout"].IsNull())→ 字段写了但值为 null，通常视为“禁用”或报错提示 -
else→ 安全调用config["timeout"].as<int>()</int>，此时已确保是合法标量
示例代码片段：
int timeout = 30;
if (config["timeout"].IsDefined()) {
if (config["timeout"].IsNull()) {
timeout = -1; // 显式 null 表示无限等待
} else {
timeout = config["timeout"].as<int>();
}
}
IsNull() 在 map 和 sequence 中的行为差异
IsNull() 只对 scalar 节点有意义。对 container 类型（map / sequence）调用它永远返回 false，哪怕该 map 是空的。
容易忽略的点：
-
config["servers"].IsNull()→ 即使servers:后面啥也没写，只要语法合法（如servers: []或servers: {}），它就不是 null，而是空容器 - 想判断 map 是否为空，用
config["servers"].size() == 0或config["servers"].IsMap() && config["servers"].size() == 0 - 想判断 sequence 是否为空，同理用
.size() == 0，而不是.IsNull()
真正需要警惕的，是那些看起来像“空配置”的场景：比如 features: null 和 features:（语法错误）完全不是一回事，前者能解析，后者直接抛 YAML::ParserException。
