应使用 YAML::Node 动态解析未知结构 YAML：先用 IsMap/IsSequence/IsScalar 判断类型，再通过 IsDefined() 检查键存在性，优先调用 as() 安全转换并支持默认值与多格式布尔/数字解析，遍历时用范围 for 避免越界。
用 yaml-cpp 读取未知结构的 YAML，别硬解成 struct
直接把不规则 YAML 映射到 C++ struct 会崩溃或丢数据——yaml-cpp 的 operator>> 要求字段名、类型完全匹配。真实配置里常有可选字段、动态 key（比如 plugins: { "auth": { ... }, "log": { ... } }），这时必须用动态节点（YAML::Node）逐层访问。
关键点：所有解析起点都是 YAML::Load() 返回的 YAML::Node，它像 JSON 的 JsonValue，支持运行时类型查询和安全下标访问。
常见错误现象：YAML::BadConversion 异常，或 node["missing_key"] 返回空节点却没检查 IsDefined() 就直接调 as<int>()</int>。
- 用
node.IsMap()/node.IsSequence()/node.IsScalar()先判断类型，再操作 - 访问 map 的 key 前，务必用
node["key"].IsDefined()检查存在性 - 读取数值/字符串时，优先用
as<t>()</t>而非隐式转换（如int x = node["x"]会静默失败）
YAML::Node 的类型安全访问：为什么 as<int>()</int> 比强制转型更可靠
as<t>()</t> 内部做了类型兼容性检查：比如 node 是字符串 "123"，as<int>()</int> 能成功；但如果是 "abc"，抛 YAML::BadConversion。而 C 风格转型（(int)node）或 static_cast 会编译失败或触发未定义行为。
立即学习“C++免费学习笔记（深入）”；
使用场景：配置项可能以字符串形式写数字（timeout: "30"），或布尔值写成小写（enabled: false）。as<t>()</t> 对 bool、double、std::string 都有内置解析逻辑。
-
node["port"].as<int>(8080)</int>：提供默认值，当 key 不存在或类型不匹配时返回8080 -
node["debug"].as<bool>(false)</bool>：接受true/false、"true"/"false"、"on"/"off"等多种写法 - 对自定义类型，需重载
operator>>，但进阶场景中极少需要——先用YAML::Node拆解，再构造对象
遍历动态 map 和 sequence：避免 iterator 失效和越界
YAML 的 map（键值对）和 sequence（列表）在 yaml-cpp 中不能用传统 for 循环索引访问——node.size() 对 map 返回键数量，对 sequence 才是元素个数；且 node[i] 对 map 无意义。
正确做法：用范围 for + begin()/end() 迭代器，或显式类型分支处理。
- map 遍历：
for (const auto& kv : node)，其中kv.first.as<:string>()</:string>是 key，kv.second是 value 节点 - sequence 遍历：
for (size_t i = 0; i ，然后 <code>node[i]取元素（node.size()对 sequence 安全） - 错误示例：
node[0]访问 map → 返回空节点；node.at(5)访问 sequence 但 size=3 → 抛std::out_of_range
嵌套深度不确定时的递归解析：如何防止栈溢出和无限循环
遇到深层嵌套（如策略配置里嵌套条件表达式再嵌套动作），递归函数容易栈溢出；若 YAML 存在循环引用（虽罕见但可能），还会无限递归。
实际做法：用显式栈（std::stack<YAML::Node>）替代函数调用栈，并限制最大深度（比如 64 层）。
- 每次 push 前检查当前栈大小，超限则报错并终止解析
- 对每个
YAML::Node，用node.IsNull()排除 null 节点干扰 - 不要依赖
node.Tag()判断循环——yaml-cpp不保留原始 anchor/alias 信息，解析后已展开
最易被忽略的是：即使结构“看起来”规则，只要配置来源不可控（比如用户上传的 YAML），就必须按动态方式处理——硬编码 struct 映射等于默认放弃容错能力。
