C++如何实现YAML与JSON格式互转_yaml-cpp结合nlohmann/json用法【实战】

浅浩君_7960

浅浩君_7960

2026-04-13

700人浏览

原创

不能直接cast或memcpy,因YAML::Node与nlohmann::json内存布局、生命周期、异常语义全不兼容;需手动递归遍历节点类型(标量/序列/映射)逐层重建,兼顾锚点、浮点精度、BOM、NaN等边界问题。

c++如何实现yaml与json格式互转_yaml-cpp结合nlohmann/json用法【实战】

直接用 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 到空 json 数组
  • 映射(map)用 for (auto it = node.begin(); it != node.end(); ++it),key 必须是 scalar,value 递归调用同一函数
  • 遇到 node.IsNull() 直接返回 json::value_t::null,别用 json(nullptr) —— 后者构造的是 object

示例片段:

arcgis-js
arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助,涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载
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\n vs \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。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2195

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3462

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1156

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3979

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6779

3

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

2024.03.01

1698

6

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1818

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2864

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习