C++如何将JSON对象平坦化(Flattening)

秋雪君_4872

秋雪君_4872

2026-07-18

332人浏览

原创

c++主流json库无原生flatten()因定位是精准解析/序列化而非数据变形;需手写递归逻辑,nlohmann/json示例覆盖对象、数组、基础值三类,注意键拼接、数组索引、null处理及类型转换。

c++如何将json对象平坦化(flattening)

JSON 平坦化在 C++ 中没有标准库原生支持,必须依赖第三方库或手写递归逻辑;jsoncpp 和 nlohmann/json 都不提供开箱即用的 flatten() 函数,得自己实现或引入额外工具。

为什么 C++ 没有现成的 flatten()?

C++ 的主流 JSON 库(如 jsoncpp、nlohmann/json)定位是「准确解析/序列化」,而非数据变形。平坦化属于数据预处理范畴,通常由下游系统(如数据库导入、日志分析 pipeline)负责,C++ 侧更倾向保持原始结构语义。

  • jsoncpp 的 Json::Value 提供 isMember()、operator[]、size() 等访问能力,但无路径展开逻辑
  • nlohmann/json 支持迭代器遍历和 get_ref(),但仍需手动拼接键名、处理数组索引
  • 强行复用 Python 的 flatten_json 思路(如用 _ 连接嵌套键)在 C++ 里要自己管理字符串拼接、内存生命周期和类型分支

用 nlohmann/json 手写 flatten 函数的关键点

以 nlohmann/json 为例,一个最小可用的扁平化函数需覆盖对象、数组、基础值三类情况,并决定分隔符和数组索引表示法:

Feishu calendar sync, local ics to json data for AI agent
Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式,用于飞书日历导入导出及数据集成。

下载
  • 递归入口建议用 std::map<:string json></:string> 或 std::unordered_map 存结果,避免重复键冲突
  • 对象键拼接:前缀非空时用 prefix + "." + key,例如 "user.profile.name"
  • 数组元素处理:对 json::array_t 中每个元素调用递归,索引用 [i](如 "items[0].id"),而非 _0 —— 后者易与合法字段名冲突
  • 注意 nullptr 值:nlohmann 将 JSON null 映射为 json::value_t::null,应存为 std::nullopt 或空字符串,别直接 .dump()
  • 类型安全:对 json::number_integer_t、json::string_t 等应统一转为 std::string 再存,或保留原始类型用 std::variant —— 后者增加下游使用成本

示例片段(仅核心逻辑):

void flatten(const nlohmann::json& j, const std::string& prefix, std::map<:string std::string>& out) {
  if (j.is_object()) {
    for (auto it = j.begin(); it != j.end(); ++it) {
      std::string key = prefix.empty() ? it.key() : prefix + "." + it.key();
      flatten(it.value(), key, out);
    }
  } else if (j.is_array()) {
    for (size_t i = 0; i 

<h3>
<a style="color:#f60; text-decoration:underline;" title="json" href="https://m.php.cn/zt/15848.html" target="_blank">json</a>cpp 用户怎么绕过缺失功能?</h3>
<p><code>jsoncpp</code> 没有迭代器友好接口,遍历对象需用 <code>getMemberNames()</code>,数组需用 <code>size()</code> + 下标访问,比 nlohmann 更 verbose:</p>
<ul>
<li>对象遍历:先调 <code>root.getMemberNames()</code> 得 <code>Json::ValueNames</code>(本质是 <code>std::vector<:string></:string></code>),再对每个 name 调 <code>root[name]</code>
</li>
<li>数组遍历:必须用 <code>for (Json::ArrayIndex i = 0; i ,<code>ArrayIndex</code> 是 typedef 的 <code>unsigned int</code>,不能直接用 <code>size_t</code></code>
</li>
<li>键名拼接同样要自己做,且 <code>Json::Value::isNull()</code> 返回 <code>true</code> 时,<code>asString()</code> 会抛异常,必须先判断类型再取值</li>
<li>若项目已绑定 <code>jsoncpp</code> 且无法切换,建议封装一层 <code>flatten_to_map()</code>,内部用 <code>std::string</code> 键 + <code>Json::Value</code> 值,避免类型擦除损失</li>
</ul>
<p>真正麻烦的不是写几行递归,而是后续怎么用这些扁平键——比如 <code>"data.items[0].meta.tags[1].name"</code> 这种键,在 C++ 里做查询、过滤、导出 CSV 时,仍得反复解析路径。平坦化只是第一步,别指望它能像 Python 那样一键喂给 <code>pandas.DataFrame</code>。</p></:string>

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

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2208

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

979

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

407

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

307

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

386

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1389

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1197

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

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

精品课程

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

共101课时 | 20.8万人学习

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

共39课时 | 4.8万人学习