不能直接cast或memcpy，因YAML::Node与nlohmann::json内存布局、生命周期、异常语义全不兼容；需手动递归遍历节点类型（标量/序列/映射）逐层重建，兼顾锚点、浮点精度、BOM、NaN等边界问题。
直接用 yaml-cpp 和 nlohmann::json 做互转，不能靠“自动桥接”——二者数据模型不兼容，必须手动遍历节点做映射。核心是把 YAML 解析成树状结构后，一层层转成 json 对象；反过来也一样。
为什么不能直接 cast 或 memcpy？
YAML 的 YAML::Node 和 nlohmann::json 是完全独立的类型，内存布局、生命周期管理、异常语义全都不一致。强行 reinterpret_cast 或依赖隐式构造会崩溃或读到垃圾值。
-
YAML::Node是引用语义，内部持有一个共享指针指向底层 representation；nlohmann::json是值语义，拷贝开销可控但不可跨库 alias - YAML 支持锚点（anchors）、标签（tags）、二进制流等 JSON 没有的特性，遇到时必须显式决定丢弃还是报错
-
yaml-cpp默认解析时不校验浮点精度，而nlohmann::json会把1.0存为 double，再 dump 出来可能变成1.0000000000000002
YAML → JSON：递归遍历 + 类型分发
关键不是“转换”，而是“重建”：用 YAML::Node 的 IsScalar()/IsSequence()/IsMap() 判断类型，再调用对应 nlohmann::json 构造方式。
- 标量（scalar）直接用
node.Scalar()转 string，再让nlohmann::json::parse()尝试解析数字/bool/null；别直接塞字符串，否则"true"会变成字符串而非布尔值 - 序列（sequence）用
for (size_t i = 0; i 遍历，push_back 到空 <code>json数组 - 映射（map）用
for (auto it = node.begin(); it != node.end(); ++it)，key 必须是 scalar，value 递归调用同一函数 - 遇到
node.IsNull()直接返回json::value_t::null，别用json(nullptr)—— 后者构造的是 object
示例片段：
立即学习“C++免费学习笔记（深入）”；
json yaml_to_json(const YAML::Node& node) {
if (node.IsScalar()) {
std::string s = node.Scalar();
// 尝试解析基础字面量
if (s == "true") return true;
if (s == "false") return false;
if (s == "null" || s == "~") return nullptr;
try { return json::parse(s); }
catch (...) { return s; } // fallback to string
}
if (node.IsSequence()) {
json j = json::array();
for (const auto& item : node) j.push_back(yaml_to_json(item));
return j;
}
if (node.IsMap()) {
json j = json::object();
for (auto it = node.begin(); it != node.end(); ++it) {
if (it->first.IsScalar()) {
j[it->first.Scalar()] = yaml_to_json(it->second);
}
}
return j;
}
return nullptr;
}
JSON → YAML：注意字符串引号和换行控制
nlohmann::json 转 YAML::Node 更简单，但容易忽略输出格式细节：
-
json::is_string()的值默认被yaml-cpp输出时不加引号，若含:、{、[等字符会导致解析失败，需手动调用node.SetString(...)并设node.SetStyle(YAML::EmitterStyle::DoubleQuoted) - 嵌套过深时，
yaml-cpp默认不换行，生成超长单行 YAML，可用YAML::Emitter emitter;手动控制缩进与折叠 -
json::is_number_float()值在 YAML 中默认输出为科学计数法（如1e-5），若需固定小数位，得先转成 string 再塞进去 - 不要用
YAML::Load(json.dump())—— 这是拿 JSON 字符串当 YAML 解析，会漏掉类型信息且无法处理 NaN/Infinity
实际项目中必须处理的边界问题
真实配置文件不是玩具数据，以下三点最容易出线上事故：
- YAML 文件带 BOM 或混合换行符（
\r\nvs\n）：yaml-cpp解析会静默失败或截断，读文件务必用 binary 模式 + 手动跳过 BOM 前三字节 - JSON 里有
NaN或Infinity：nlohmann::json允许存，但yaml-cpp不支持，转之前得用std::isnan()/std::isinf()检查并替换为 null 或抛异常 - 字段名含 Unicode 或控制字符：
yaml-cpp允许，但某些旧版 YAML 解析器（如 Python 2.7 的 PyYAML）会崩，建议在入库前统一 normalize 键名
最麻烦的其实是“单向写入”场景：比如只从 YAML 读配置、转成 JSON 给前端用，那就没必要实现完整双向，砍掉 JSON→YAML 分支能省掉 70% 的维护成本和潜在 bug。
