C++如何解析JSON文件

煙雲

煙雲

2026-08-03

266人浏览

原创

最常用方式是用std::ifstream直接传给nlohmann::json::parse(),v5.3.0+自动跳过utf-8 bom;访问嵌套字段应优先用.value("key", default)避免崩溃;大文件需考虑流式解析器如simdjson;中文乱码主因是文件或源码编码不统一,须全用utf-8无bom。

c++如何解析json文件

用 nlohmann/json 直接读取文件到 json 对象

最常用、最省事的方式就是用 nlohmann::json 库配合 std::ifstream,它原生支持从流解析 JSON。只要文件编码是 UTF-8(无 BOM),基本不会出错。

常见错误现象:json::parse_error 异常,通常是因为文件为空、路径错、含不可见控制字符(比如 Windows 记事本保存的 UTF-8+BOM)、或 JSON 格式本身不合法(漏逗号、多逗号、单引号代替双引号)。

  • 确保文件路径正确,建议用绝对路径或检查 std::ifstream.is_open() 返回值
  • 不要手动读成 string 再 parse——除非你要预处理(如删注释),否则直接传流更安全
  • 如果文件带 BOM,nlohmann/json 5.3.0+ 版本能自动跳过,但低版本会报 [json.exception.parse_error.101]
std::ifstream f("config.json");
if (!f.is_open()) {
    throw std::runtime_error("cannot open config.json");
}
nlohmann::json j = nlohmann::json::parse(f); // 自动处理 UTF-8 BOM(v5.3.0+)

访问嵌套字段时怎么避免崩溃

JSON 字段缺失是常态,直接用 ["key"] 下标访问会触发断言或抛异常(out_of_range)。必须用安全访问方式。

使用场景:配置文件里某些字段是可选的,比如 "timeout" 可能不存在,但代码里又想给个默认值。

  • .value("key", default_value):类型必须匹配,且只适用于基础类型(intstd::string 等)
  • .at("key"):显式抛异常,适合“该字段必须存在”的逻辑分支
  • .find("key") != j.end() 判断是否存在,再取值;适合需要复杂默认逻辑的场景
int timeout = j.value("timeout", 30);                    // 安全,默认 30
std::string host = j.value("server.host", "localhost"); // 支持点号路径(v3.11.2+)
auto port_it = j.find("port");
int port = port_it != j.end() ? port_it->get<int>() : 8080;
</int>

解析大 JSON 文件时内存暴涨怎么办

nlohmann/json 是 DOM 解析器,整个 JSON 必须加载进内存。一个 100MB 的 JSON 文件,解析后可能占用 300MB+ 内存,尤其含大量字符串时。

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

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

下载

性能影响:不仅吃内存,还拖慢启动——解析时间随文件大小近似线性增长。

  • 确认是否真需要全量加载:如果只是查几个字段,考虑用流式解析器(如 simdjsonrapidjson 的 SAX 模式)
  • nlohmann/json 时,可提前调用 j.clear() 释放不用的子树
  • 避免反复解析同一文件:缓存 nlohmann::json 对象,别每次读都 parse

注意:simdjson 要求输入内存连续且只读,不能像 std::ifstream 那样边读边解析;若文件超大又不能全载入,得自己 mmap + simdjson::dom::parser

中文字段名或字符串乱码的根源在哪

不是库的问题,而是文件保存格式和 C++ 运行环境的组合问题。Windows 上用记事本保存为 UTF-8,实际加了 BOM;而 VS 默认源码编码是 GBK,std::string 字面量若含中文,编译后就是 GBK 编码字节——和 JSON 里的 UTF-8 中文混在一起就崩。

  • 统一用 UTF-8 无 BOM 保存 JSON 文件(推荐 VS Code 或 Notepad++)
  • C++ 源码也存为 UTF-8 无 BOM,并在文件头加 #pragma execution_character_set("utf-8")(MSVC)或用 u8"中文" 前缀字面量
  • 打印调试时,别用 std::cout 直接输出中文——终端编码可能不匹配,改用日志写文件再查看

最容易被忽略的是:即使 JSON 解析成功,j["中文键"].get<:string>()</:string> 返回的仍是 UTF-8 编码的 std::string,后续若要 WinAPI 调用(如 CreateFileA),得先转 GBK 或用宽字符接口。

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

832

9

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

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

2024.03.14

753

6

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

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

2024.03.14

243

5

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

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

2024.03.14

242

5

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

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

2024.03.14

224

5

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

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

2024.03.14

460

5

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

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

2024.03.21

1105

9

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

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

2024.03.22

857

7

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

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

2024.03.25

1020

9

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

C# 教程
C# 教程

共94课时 | 20.1万人学习