C++如何将对象转换为JSON字符串

老晨君_8202

老晨君_8202

2026-08-02

960人浏览

原创

nlohmann/json 序列化需手动定义 to_json 函数,支持嵌套与容器,私有/const 成员需友元或 getter,utf-8 编码须确保输入合法,性能优化应避免重复构造及跨模块 odr 问题。

c++如何将对象转换为json字符串

用 nlohmann/json 库序列化 C++ 对象最直接

没有标准库支持,必须依赖第三方 JSON 库;nlohmann/json 是目前最主流的选择,头文件即用、语法贴近直觉,且对自定义类型支持清晰。

关键前提是:你的类必须显式定义如何映射到 JSON,不能靠自动反射(C++ 没运行时类型信息)。

  • 在类内声明 to_json 函数(非成员、非模板),接受 json& 和 const 引用对象
  • 或在命名空间中为该类重载 to_json,注意需与类在同一命名空间或被 ADL 找到
  • 字段名必须手动写死字符串,不支持宏自动生成字段名(除非额外引入 codegen 工具)
  • 嵌套对象、std::vector、std::map 等容器可直接赋值,库会递归处理
struct Person {
    std::string name;
    int age;
};
<p>void to_json(nlohmann::json& j, const Person& p) {
j = nlohmann::json{{"name", p.name}, {"age", p.age}};
}</p><p>// 使用
Person p{"Alice", 30};
std::string s = nlohmann::json(p).dump(); // → {"name":"Alice","age":30}
</p>

遇到 const 成员或私有字段怎么办

编译失败常见于字段不可访问或不可拷贝——to_json 函数体内访问私有成员时,需将其声明为友元,或改用 public getter。

wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support

基于三引擎设计,从微信文章、新闻和博客网页提取干净内容,支持标题作者日期元数据,多格式和批量处理。

下载
  • 加 friend void to_json(...) 到类定义里是最简洁的解法
  • 若字段是 const 或只有 const getter,确保 getter 返回的是可序列化的类型(如 const std::string& 可直接用)
  • 避免在 to_json 中调用可能抛异常的 getter,否则 dump() 可能中途失败
  • 不要试图在 to_json 里修改对象状态——它应是纯读取操作

中文乱码或特殊字符出错

nlohmann/json 默认输出 UTF-8,但如果你看到 或空字符串,大概率是输入字符串本身不是合法 UTF-8(比如 GBK 编码的 char* 被误当 UTF-8 解析)。

  • 确认源字符串变量确实是 UTF-8 编码;Windows 控制台默认 ANSI,std::string 从 cin 读入时可能已损坏
  • 不用手动转义,库会自动处理引号、反斜杠、控制字符;但非法字节序列会导致 dump() 抛 nlohmann::json::type_error
  • 调试时可用 j.dump(2) 加缩进,方便肉眼检查结构,但不影响编码逻辑
  • 若需严格控制输出格式(如禁止 Unicode 转义 \uXXXX),用 json::dump_options 配置,但非常规需求

性能敏感场景要注意什么

每次调用 json(obj).dump() 都触发完整构造 + 序列化,临时对象多、内存分配频繁。

  • 避免在 tight loop 里反复序列化同一对象;可缓存 nlohmann::json 实例(只要对象不变)
  • dump() 默认分配新 string,如需写入已有 buffer,用 dump(std::string&) 重载减少拷贝
  • 深度嵌套或超大数组时,栈空间可能不足;可设编译宏 NLOHMANN_JSON_DISABLE_EXCEPTIONS 关异常,改用返回错误码风格(需自行封装)
  • 不推荐为性能过早优化——先测再调;99% 场景下,语义清晰比省几十纳秒更重要

真正麻烦的是跨模块共享序列化逻辑:一旦类定义在 A 库,to_json 实现放在 B 库,链接期可能 ODR-violation。最稳的方式是把 to_json 定义和类声明放在一起,或至少确保只在一个 TU 中实例化。

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

相关文章

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

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

下载

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

相关专题

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

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

2024.03.14

2228

9

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

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

2024.03.14

1019

6

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

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

2024.03.14

427

5

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

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

2024.03.14

327

5

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

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

2024.03.14

406

5

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

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

2024.03.14

580

5

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

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

2024.03.21

1409

9

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

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

2024.03.22

1217

7

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

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

2024.03.25

1325

9

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习