YAML::Node 不是原生 C++ 容器，node["key"] 返回的是类型擦除的句柄；需先用 IsSequence() 判断是否为序列，再通过下标或迭代器访问元素。
yaml-cpp 读取 YAML 数组时，node["key"] 返回的是 YAML::Node，不是原生 C++ 容器
很多人以为 node["items"] 拿到的就是 std::vector 或类似结构，结果直接 auto vec = node["items"]; 后尝试 vec.size() 就报错 —— 因为 YAML::Node 是一个类型擦除的句柄，它内部可能是标量、映射、序列或空节点。必须显式判断并转换。
正确做法是先用 IsSequence() 确认类型，再用下标或迭代器访问：
YAML::Node items = config["items"];
if (items.IsSequence()) {
for (size_t i = 0; i < items.size(); ++i) {
YAML::Node item = items[i]; // 每个 item 仍是 YAML::Node
if (item.IsMap()) {
std::string name = item["name"].as<std::string>();
int age = item["age"].as<int>();
}
}
}注意：items.size() 是安全的，但 items[i] 越界不会抛异常，而是返回一个空节点（IsDefined() == false），建议配合 IsDefined() 检查。
遍历 YAML 序列时，用 begin()/end() 迭代器比下标更符合习惯，且支持 range-for
虽然下标访问直观，但 YAML::Node 的序列支持标准迭代器接口，写法更 C++ 化，也避免手写索引越界风险：
立即学习“C++免费学习笔记（深入）”；
for (const YAML::Node& item : items) {
if (!item.IsMap()) continue;
std::string role = item["role"].as<std::string>();
double weight = item["weight"].as<double>(1.0); // 提供默认值
}要点：
-
item是 const 引用，避免拷贝； -
as<T>(default)第二个参数是 fallback 值，当字段缺失或类型不匹配时返回它（仅对基本类型有效）； - 如果字段可能不存在，别直接
item["xxx"].as<int>()，先用item["xxx"].IsDefined()判断； - 迭代器遍历顺序和 YAML 文件中顺序一致，yaml-cpp 保留原始顺序。
as<std::vector<T>>() 不能直接解析嵌套对象数组，必须手动展开
常见误区：看到 items 是对象数组，就想用 items.as<std::vector<MyStruct>>() 一步到位。yaml-cpp 不支持自动将 YAML 序列反序列化为自定义 struct vector，除非你显式重载 convert<MyStruct>。
两种可行路径：
- 手动循环 + 构造：每个
item调用as<MyStruct>()（前提是已注册convert<MyStruct>）； - 保持为
std::vector<YAML::Node>，延迟解析（适合部分字段可选、结构动态的场景）； - 若只用基础类型数组（如
std::vector<int>），items.as<std::vector<int>>()是可以直接用的。
注册自定义类型转换示例（必须在解析前完成）：
namespace YAML {
template<>
struct convert<MyStruct> {
static Node encode(const MyStruct& rhs) { /* 不需要 */ }
static bool decode(const Node& node, MyStruct& rhs) {
if (!node.IsMap()) return false;
rhs.name = node["name"].as<std::string>();
rhs.count = node["count"].as<int>(0);
return true;
}
};}嵌套过深或字段缺失时，as<T>() 抛 YAML::BadConversion，不是所有异常都来自类型错误
比如 node["config"]["servers"][0]["port"].as<int>() 中任意一级 key 不存在、或 [0] 越界、或 "port" 是字符串而非数字，都会触发同一个异常类型。靠 try/catch 捕获 YAML::BadConversion 并不够精准。
更健壮的做法是逐层检查：
auto config = node["config"]; if (!config.IsDefined()) return; auto servers = config["servers"]; if (!servers.IsSequence() || servers.size() == 0) return; auto port_node = servers[0]["port"]; if (!port_node.IsDefined() || !port_node.IsScalar()) return; int port = port_node.as<int>();
关键点：
-
IsDefined()比IsScalar()/IsSequence()更前置，应最先调用； -
as<int>()对非标量节点（如 map、null）也会抛异常，所以先IsScalar()； - 调试时打印
node.Type()和node.ToString()很有用，尤其面对第三方 YAML 配置格式不规范时。
最易被忽略的是：yaml-cpp 默认不校验浮点数溢出，"999999999999999999999" 这种超长数字转 double 可能静默变为 inf，需业务侧额外校验范围。
