YAML::Node::Type() 返回6种枚举值：Null、Scalar、Sequence、Map、Undefined、BadAlias；其中Undefined表示未初始化或键不存在，BadAlias表示非法别名引用。
YAML::Node::Type() 返回值有哪些可选类型
YAML-CPP 中 YAML::Node 的类型判断不靠属性（如 NodeType），而是调用成员函数 Type()，它返回枚举值 YAML::NodeType::value_t。这个枚举只有 6 个合法值：Null、Scalar、Sequence、Map、Undefined、BadAlias。
注意：Undefined 表示节点未被正确初始化（比如空构造或解析失败后残留），BadAlias 是解析时遇到非法别名引用才会出现，正常业务中几乎不会主动构造这两种。
常见误判场景：把 node["missing_key"] 当作不存在的 key 就直接调 Type() —— 实际上 YAML-CPP 会返回一个 Undefined 节点，而非抛异常或返回 Null。
判断节点是否存在且非 Undefined 的安全写法
直接对未定义 key 调用 Type() 容易掩盖逻辑错误。应先用 IsDefined() 确认节点有效，再判断具体类型：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
if (node["port"].IsDefined()) {
switch (node["port"].Type()) {
case YAML::NodeType::Scalar:
// 安全取 string 或数字
break;
case YAML::NodeType::Null:
// 显式处理 null 值（YAML 中写成 ~ 或 null）
break;
default:
// 非预期类型，报错或跳过
}
} else {
// key 根本不存在，不是 null，也不是 undefined 类型本身
}
-
IsDefined()是必须前置检查，否则Undefined节点调Type()虽不崩溃，但行为不符合直觉 -
IsNull()可单独用，但它只对明确为Null类型的节点返回 true；IsDefined() && !IsNull()才表示“存在且非空” - 不要依赖
node["x"]返回值是否为 false —— YAML-CPP 没有重载 bool 转换，这样写编译不过
Scalar 类型下如何安全转成整数或浮点数
Scalar 是最易出错的类型：内容可能是 "123"、"0x7B"、"3.14"、"true"、甚至 "2024-01-01"，但 as<int>() 或 as<double>() 在转换失败时默认抛 YAML::BadConversion 异常，而非静默失败。
实战建议始终用 try/catch 或先校验再转换：
if (node["timeout"].IsDefined() && node["timeout"].IsScalar()) {
try {
int t = node["timeout"].as<int>();
} catch (const YAML::BadConversion&) {
// 处理非法数值，例如日志警告 + 设默认值
}
}
- 避免无保护地调
as<T>()，尤其输入来自配置文件或网络时 -
as<std::string>()几乎总是安全的（除非内存耗尽），但要注意 YAML 中带引号和不带引号的 scalar 都会转成 string - 想支持十六进制或科学计数法？YAML-CPP 默认解析器已支持，无需额外配置
Sequence 和 Map 的遍历前必须先确认类型
对 Sequence 调 size() 或用 range-for 是安全的；对 Map 调 size() 或迭代也是安全的。但若节点其实是 Scalar 却强行当 Sequence 遍历，运行时会抛 YAML::InvalidNode 异常。
典型错误写法：
// ❌ 危险！没检查类型就迭代
for (auto& item : node["list"]) { ... }
// ✅ 正确顺序
if (node["list"].IsDefined() && node["list"].IsSequence()) {
for (auto& item : node["list"]) {
// item 是 YAML::Node，仍需按需判断其 Type()
}
}
-
IsSequence()和IsMap()是类型断言的快捷方式，内部就是比对Type() == Sequence/Map - 嵌套结构里每一层都要独立判断 —— 外层是
Map，内层某个 value 仍可能是Scalar或Undefined - YAML-CPP 不支持类似 JSON 的 “duck typing”，不能靠有没有
size()或begin()来推断类型
最容易被忽略的是 Undefined 节点的传播性：一旦某个 key 不存在，后续链式访问（如 node["a"]["b"]["c"]）都会得到 Undefined，而不会在中途报错。务必在每级访问后做 IsDefined() 检查，或封装工具函数统一处理。
