C++如何解析JSON格式的字符串

幻夢星雲

幻夢星雲

2026-07-31

160人浏览

原创

最直接的方法是使用 nlohmann::json::parse() 解析 json 字符串,需配合 try-catch 处理非法输入,因其 header-only、语法简洁、支持 c++11 且无需编译依赖。

c++如何解析json格式的字符串

nlohmann/json 解析 JSON 字符串最直接

绝大多数 C++ 项目现在都用 nlohmann/json 库,它 header-only、语法简洁、支持 C++11 起,不用编译依赖。你只要下载一个 json.hpp 文件放进工程,#include 就能开始解析。

常见错误是直接拿 std::string 构造 json 对象却没检查是否合法:

std::string s = R"({"name":"Alice","age":30})";
try {
    auto j = nlohmann::json::parse(s); // 必须 try-catch
    std::cout () 
  • parse() 不会自动抛异常——只有非法 JSON 才抛 nlohmann::json::parse_error,但空字符串、nullptr 字符串也会触发
  • 如果确定输入安全(比如自己生成的),可用 nlohmann::json j = s; 简写,但生产环境不建议绕过 try/catch
  • 字段访问前最好用 j.contains("key")j.is_object() 做类型/存在性检查,否则 j["missing"].get<int>()</int> 会抛 out_of_range

从 JSON 字符串提取整数、字符串、布尔值要注意类型匹配

nlohmann::json 是类型擦除设计,取值必须显式声明目标类型,不能靠隐式转换。常见坑是把 "123" 当成数字取,或把 123 当成字符串取。

示例:

std::string s = R"({"count":42,"active":true,"id":"abc123"})";
auto j = nlohmann::json::parse(s);
// ✅ 正确
int count = j["count"].get<int>();           // 42
bool active = j["active"].get<bool>();       // true
std::string id = j["id"].get<:string>(); // "abc123"
<p>// ❌ 错误(运行时报错:type must be number, but is string)
// int bad = j["id"].get<int>();</int></p>
<p>// ✅ 安全写法:先判断类型再取
if (j["count"].is_number_integer()) {
int n = j["count"].get<int>();
}</int></p></:string></bool></int>
  • .get<t>()</t> 要求 JSON 值类型与 T 严格匹配:JSON numberint/doublestringstd::stringtrue/falsebool
  • JSON 中的数字默认是 double,即使写的是 42。想确保整数用 is_number_integer() 判断,或用 get<int64_t>()</int64_t> 配合检查溢出
  • 字符串字段若可能为 null,要用 j.value("key", "default") 提供 fallback,而不是直接 j["key"]

解析嵌套对象和数组时别漏掉边界检查

JSON 里嵌套太常见了,比如 {"user":{"profile":{"email":"a@b.com"}}}{"items":[1,2,3]}。直接链式访问 j["user"]["profile"]["email"] 看似方便,但任意一层缺失都会抛异常。

php版微信js-sdk支付接口类
php版微信js-sdk支付接口类

php版微信js-sdk支付接口类

下载

更稳妥的做法是逐层判空:

auto j = nlohmann::json::parse(json_str);
if (j.is_object() && 
    j.contains("user") && j["user"].is_object() &&
    j["user"].contains("profile") && j["user"]["profile"].is_object() &&
    j["user"]["profile"].contains("email")) {
    std::string email = j["user"]["profile"]["email"].get<:string>();
}</:string>
  • 也可以用 j.value("user", nlohmann::json::object()).value("profile", nlohmann::json::object()).value("email", ""),但可读性差,且无法区分“字段不存在”和“字段值为 null
  • 遍历数组时,用 for (const auto& item : j["items"]) 即可,但得先确认 j["items"].is_array(),否则迭代器行为未定义
  • 数组索引越界不会自动 throw,j["items"][100] 返回一个空的 json 对象(is_null() == true),需手动检查

不用第三方库时,std::regexrapidjson 的取舍

如果项目禁止引入外部头文件(比如某些嵌入式或军工场景),std::regex 解析 JSON 是典型反模式:JSON 语法递归嵌套,正则无法可靠处理引号转义、嵌套对象/数组等,极易漏匹配或崩溃。

真正可行的轻量替代是 rapidjson,它比 nlohmann 更底层,但体积小、性能高、无 STL 依赖(可禁用 std::string):

  • rapidjson 默认用 SAX 模式流式解析,内存占用低;DOM 模式类似 nlohmann,用 Document 加载整个 JSON
  • 错误处理靠返回码:ParseResult ok = doc.Parse(json_str.c_str()); if (!ok) { ... },错误位置在 doc.GetErrorOffset()
  • 取值方式更啰嗦:doc["name"].GetString() 要求字段存在且类型匹配,否则 crash;必须配合 HasMember()IsString() 一起用

除非有硬性约束,否则没必要为省几百 KB 头文件去换 rapidjson —— nlohmann/json 编译后体积影响极小,调试体验和安全性远胜手写解析逻辑。

最易被忽略的是编码:所有解析库默认按 UTF-8 处理,如果输入字符串实际是 GBK 或 UTF-16,必须先转码,否则 parse() 会失败或乱码。别指望库自动检测编码。

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

857

9

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

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

2024.03.14

754

6

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

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

2024.03.14

245

5

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

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

2024.03.14

243

5

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

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

2024.03.14

224

5

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

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

2024.03.14

470

5

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

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

2024.03.21

1136

9

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

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

2024.03.22

884

7

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

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

2024.03.25

1063

9

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RabbitMQ 教程手册
RabbitMQ 教程手册

共0课时 | 0人学习

Linux man-pages 项目
Linux man-pages 项目

共0课时 | 0人学习

C# 教程
C# 教程

共94课时 | 20.2万人学习