c++如何读取JSON配置文件_nlohmann/json库基础用法【详解】

冬伟酱_7517

冬伟酱_7517

2026-03-19

302人浏览

原创

用nlohmann::json读取本地json文件需先用std::ifstream打开并检查is_open(),再调用json::parse(ifs, nullptr, false)禁用异常,通过is_discarded()判断解析是否成功;访问嵌套字段应优先用at()或contains()校验存在性;整数读取推荐get()避免截断;windows下需处理中文路径和utf-8 bom问题。

c++如何读取json配置文件_nlohmann/json库基础用法【详解】

怎么用 nlohmann::json 读取本地 JSON 文件

直接调用 json::parse 配合文件流即可,但别跳过异常处理——JSON 格式错一个逗号就崩溃。

  • 用 std::ifstream 打开文件,检查是否成功(is_open()),否则 json::parse 会抛 parse_error
  • 推荐用 json::parse(ifs, nullptr, false):第三个参数设为 false 可禁用异常,改用返回值判断解析是否成功
  • 不要用 json j = json::parse(ifs) 这种写法——一旦失败直接 terminate,线上服务扛不住
std::ifstream ifs("config.json");
if (!ifs.is_open()) {
    // 处理文件不存在或权限问题
}
nlohmann::json j = nlohmann::json::parse(ifs, nullptr, false);
if (j.is_discarded()) {
    // 解析失败,j 为空且不可用
}

访问嵌套字段时为什么总报 out_of_range

因为 nlohmann::json 的 operator[] 在键不存在时**不报错也不返回 null,而是自动插入默认值**;真要安全访问,得用 at() 或先检查 contains()。

  • j["server"]["port"]:如果 "server" 不存在,会创建一个空对象,再取 "port" 得到 null,后续转 int 就崩
  • j.at("server").at("port").get<int>()</int>:任一层缺失都抛 out_of_range,适合明确要求字段必须存在
  • 更稳的做法是:j.contains("server") && j["server"].contains("port") && j["server"]["port"].is_number()

整数类型读取不准?get<int>()</int> 和 get<int64_t>()</int64_t> 怎么选

JSON 规范里没有整型位宽概念,nlohmann 默认用 int64_t 存数字;但如果你直接 get<int>()</int>,遇到超 INT_MAX 的值会静默截断——不报错,结果错得离谱。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • 配置中端口号、ID 类字段,优先用 get<long>()</long> 或 get<int64_t>()</int64_t>
  • 如果确定是小整数(如开关标志 "debug": 1),可用 get<int>()</int>,但建议加范围校验:auto v = j["debug"].get<int>(); if (v != 0 && v != 1) { /* 拒绝非法值 */ }</int>
  • 浮点字段别用 get<double>()</double> 强转整数——"timeout": 30.0 可以,但 "timeout": 30.5 转 int 会丢精度

Windows 下中文路径或 UTF-8 BOM 导致解析失败

不是库的问题,是 C++ 标准文件流在 Windows 上默认按 ANSI 打开文件,含中文路径直接失败;BOM 则会让 json::parse 把开头三个字节当非法字符。

  • 路径含中文:用 std::wifstream + std::codecvt_utf8<wchar_t></wchar_t> 转换,或改用跨平台路径 API(如 std::filesystem::u8path + std::ifstream)
  • BOM 问题:读文件前跳过 UTF-8 BOM(EF BB BF),三字节判断后 seekg(3)
  • 更省事的办法:统一用文本编辑器保存 JSON 为「UTF-8 无 BOM」格式,开发期就掐死源头

nlohmann/json 的坑不在语法难,而在它太“宽容”——自动补空对象、静默类型转换、不校验业务逻辑。真正上线前,每个配置字段都得过一遍「缺失、越界、类型错、编码乱」这四关。

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

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

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

下载

相关标签:

c++

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

相关专题

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

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

2023.08.07

2095

5

json是什么
json是什么

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

2023.08.23

3142

1

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

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

2023.10.13

1056

3

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

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

2025.09.10

3579

7

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

1678

6

string转int
string转int

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

2023.08.02

6139

3

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.29

2985

6

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.29

3848

10

热门下载

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

精品课程

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

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

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

共0课时 | 0人学习