使用nlohmann/json库解析JSON最便捷,只需引入json.hpp头文件,通过json::parse()将字符串转为对象,支持现代C++语法,操作直观。

在C++中解析JSON数据,最常用且便捷的方式是使用第三方库 nlohmann/json。这个头文件-only 的库轻量、易用,支持现代C++语法,能轻松实现JSON的解析、生成和操作。
1. 安装与引入 nlohmann/json 库
由于 nlohmann/json 是一个头文件-only 的库,集成非常简单:
- 通过vcpkg或conan安装:适用于项目管理工具用户。
-
直接下载 single_include 版本:从 GitHub 下载
json.hpp文件,放入项目 include 目录。 -
使用包管理器(如Ubuntu):
sudo apt install nlohmann-json3-dev
在代码中引入头文件即可使用:
#includeusing json = nlohmann::json;
2. 解析JSON字符串
将一段JSON格式的字符串转换为可操作的对象非常简单:
立即学习“C++免费学习笔记(深入)”;
std::string json_str = R"({
"name": "Alice",
"age": 25,
"city": "Beijing",
"hobbies": ["reading", "coding"]
})";
json j = json::parse(json_str);
std::cout << "Name: " << j["name"] << std::endl;
std::cout << "Age: " << j["age"] << std::endl;
std::cout << "First hobby: " << j["hobbies"][0] << std::endl;
输出结果:
Name: "Alice" Age: 25 First hobby: "reading"
3. 访问和操作JSON对象
你可以像使用标准容器一样访问JSON对象的字段:
- 使用
[]操作符获取值(自动创建不存在的键) - 使用
at()方法更安全地访问(越界会抛异常) - 判断字段是否存在:
j.contains("key") - 遍历对象:
for (auto& [key, value] : j.items()) {
std::cout << key << " : " << value << std::endl;
}
4. 序列化回JSON字符串
修改数据后,可以轻松转回字符串:
j["age"] = 26; j["married"] = false; std::string output = j.dump(2); // 格式化缩进2格 std::cout << output << std::endl;
输出示例:
{
"age": 26,
"city": "Beijing",
"hobbies": ["reading", "coding"],
"married": false,
"name": "Alice"
}
基本上就这些。nlohmann/json 让C++处理JSON变得直观又高效,适合配置读取、网络接口数据交换等场景。只要记得处理好异常(比如解析失败),就能稳定运行。不复杂但容易忽略细节,比如类型检查和编码问题。









