使用nlohmann/json库可方便地在c++中解析json文件,需包含json.hpp头文件并通过ifstream读取文件内容,再用try-catch解析为json对象,支持通过键访问字符串、整数、数组等数据类型,并可遍历对象或处理嵌套结构。

在C++中读取和解析JSON文件,由于标准库不直接支持JSON操作,通常需要借助第三方库来完成。目前最常用且易用的库是 nlohmann/json,它是一个头文件-only的库,使用方便,语法简洁。
1. 安装与引入 nlohmann/json 库
这个库只需下载一个头文件即可使用。
方法一:通过 vcpkg 或 conan 包管理器安装(推荐)
- 使用 vcpkg:
vcpkg install nlohmann-json - 使用 conan: 添加
nlohmann_json到依赖
方法二:手动引入头文件
- 从 gitHub 下载单头文件版本:https://www.php.cn/link/3218b56a27cc5d3acdac4a6b99195f75
- 将
json.hpp放入项目 include 目录 - 在代码中包含:
#include "json.hpp"
2. 读取并解析 JSON 文件
以下是一个完整的示例,展示如何读取本地 JSON 文件并解析内容。
立即学习“C++免费学习笔记(深入)”;
#include <iostream> #include <fstream> #include <string> #include "json.hpp" // 使用命名空间简化代码 using json = nlohmann::json; int main() { // 打开 JSON 文件 std::ifstream file("config.json"); // 检查文件是否打开成功 if (!file.is_open()) { std::cerr << "无法打开文件 config.json" << std::endl; return -1; } // 将文件内容解析为 JSON 对象 json j; try { file >> j; } catch (const std::exception& e) { std::cerr << "JSON 解析失败:" << e.what() << std::endl; return -1; } // 关闭文件 file.close(); // 访问 JSON 数据(假设是对象类型) if (j.contains("name")) { std::cout << "姓名: " << j["name"].get<std::string>() << std::endl; } if (j.contains("age")) { std::cout << "年龄: " << j["age"].get<int>() << std::endl; } // 如果有数组字段 if (j.contains("hobbies") && j["hobbies"].is_array()) { std::cout << "兴趣爱好: "; for (const auto& hobby : j["hobbies"]) { std::cout << hobby.get<std::string>() << " "; } std::cout << std::endl; } return 0; }
对应的 config.json 示例内容:
Find JSON Path Online
30
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
30 “`json { “name”: “张三”, “age”: 25, “hobbies”: [“读书”, “游泳”, “编程”] } “`
3. 常见操作说明
- 判断键是否存在:使用
j.contains("key") - 获取不同数据类型:用
.get<t>()</t>方法,如get<int>()</int>、get<bool>()</bool>、get<:string>()</:string> - 处理嵌套对象:可以链式访问,如
j["address"]["city"] - 遍历 JSON 对象:
for (auto& [key, value] : j.items()) { std::cout << key << " = " << value << std::endl; }
4. 编译方式(g++ 示例)
确保包含正确的路径:
g++ -std=c++17 main.cpp -o read_json
如果使用了包管理器,可能还需要链接或指定 include 路径。
基本上就这些。nlohmann/json 让 C++ 处理 JSON 变得非常直观,适合大多数中小型项目使用。
