不推荐直接用Node::IsEqual()比较YAML内容，因其仅浅层比较、忽略浮点精度、类型差异、锚点展开等；应手写深度遍历函数，按类型分支处理，严格区分字符串相等与数值相等，并注意编码、异常、注释丢失等问题。
YAML解析后用Node::IsEqual()直接比是否可靠
不推荐直接用 Node::IsEqual() 判断两个 YAML 文件内容是否一致。它只做浅层结构+值相等判断，对浮点数精度、整数与浮点表示（如 42 vs 42.0）、时间戳格式、锚点/别名展开状态等不敏感，且不同解析器（libyaml vs ryml）行为可能不一致。
更稳妥的做法是：先完整加载为 YAML::Node，再递归遍历比较每个节点的类型、值、子节点数量和顺序。
-
YAML::Node的IsEqual()不处理 NaN/Inf 的语义一致性 - 若文件含锚点（
&id）和别名（*id），IsEqual()可能因引用展开差异返回 false，即使逻辑等价 - 空映射
{}和空序列[]类型不同，但某些场景下用户期望“都为空”即视为一致——需按业务定义
手写深度遍历函数时如何处理类型与值的精确匹配
核心是统一类型判定优先于值比较，避免隐式转换干扰。libyaml 绑定的 YAML::Node 提供 Type() 枚举，必须显式分支处理：
bool deepEqual(const YAML::Node& a, const YAML::Node& b) {
if (a.Type() != b.Type()) return false;
switch (a.Type()) {
case YAML::NodeType::Scalar:
return a.Scalar() == b.Scalar(); // 字符串级相等，不转数字
case YAML::NodeType::Sequence:
if (a.size() != b.size()) return false;
for (std::size_t i = 0; i < a.size(); ++i)
if (!deepEqual(a[i], b[i])) return false;
return true;
case YAML::NodeType::Map:
if (a.size() != b.size()) return false;
for (auto it = a.begin(); it != a.end(); ++it) {
if (!b[it->first]) return false;
if (!deepEqual(it->second, b[it->first])) return false;
}
return true;
default:
return a.IsNull() == b.IsNull();
}
}- 不用
a.as<int>()或a.as<double>()做值比较——会触发类型转换，丢失原始表示 - Map 遍历时必须用
b[it->first]而非b[it->first.Scalar()]，因为 key 本身可能是非标量（如序列或映射，虽然少见） - YAML 允许重复 key，但
YAML::Node默认只保留最后一个，所以该实现默认接受“后覆盖”语义
浮点数、时间、二进制字段在深度对比中怎么算“一致”
原始 YAML 文本中 3.1415、3.141500、3.1415e0 解析后都是 double，但字符串值不同。是否一致取决于你的校验目标：
立即学习“C++免费学习笔记（深入）”；
- 若校验配置文件语义等价（如 CI 参数），应走数值比较：
std::abs(a.as<double>() - b.as<double>()) < 1e-9 - 若校验版本控制 diff 或签名输入，必须用
a.Scalar() == b.Scalar()保证字面量完全一致 - 时间字段（
2023-01-01T00:00:00Z）建议统一 parse 成std::chrono::system_clock::time_point再比，避免时区/格式歧义 - 二进制（
!!binary）需 base64 解码后比原始字节，不能比编码后的字符串
用 YAML::LoadFile() 加载时容易忽略的编码与异常边界
YAML::LoadFile() 默认按系统 locale 解码，遇到 UTF-8 BOM 或含中文路径时可能失败。实际使用必须包裹异常并指定编码上下文：
- 总是用
try { YAML::Node n = YAML::LoadFile("a.yaml"); } catch (const YAML::Exception& e) { /* 检查 e.msg */ } - Windows 下路径含中文，需用
std::filesystem::u8path()转 UTF-8 字符串传入（C++20）；旧标准可用std::wstring_convert<std::codecvt_utf8<wchar_t>>().to_bytes(wpath) - 大文件（>10MB）可能导致栈溢出，建议调高线程栈或改用流式解析（
YAML::Parser+YAML::EventHandler） - 两个文件一个有注释、一个没注释，
YAML::Node无法保留注释信息，深度对比天然忽略——这点常被误认为“对比不准”
深度对比真正难的不是写递归，而是厘清“什么算一致”：是字面量、语义、还是运行时行为等价。业务规则一旦模糊，代码越严谨越容易出反直觉结果。
