C++如何使用nlohmann/json库解析JSON_C++ JSON处理库nlohmann/json使用

nlohmann/json 是C++中处理JSON的常用库，只需包含json.hpp头文件即可使用，支持C++11及以上版本，提供简洁语法进行JSON解析、生成和操作。

在C++中处理JSON数据时，nlohmann/json 是一个非常流行且易用的开源库。它不依赖外部库，只需包含头文件即可使用，支持现代C++语法（如C++11及以上），能轻松实现JSON的解析、生成和操作。

安装与配置 nlohmann/json

最简单的方式是通过单个头文件引入：

• 从GitHub下载最新版本：https://www./link/b82e68e6366d4177332acdf3fa4d1e3a
• 将 json.hpp 文件放入项目include目录
• 在代码中包含：#include

如果你使用的是包管理工具：

• vcpkg: vcpkg install nlohmann-json
• conan: 添加 nlohmann_json/3.11.2 到依赖
• Linux (Ubuntu): sudo apt install nlohmann-json3-dev

基本 JSON 解析示例

假设有一个JSON字符串：

std::string json_str = R"({
  "name": "Alice",
  "age": 25,
  "is_student": false,
  "hobbies": ["reading", "coding"],
  "address": {
    "city": "Beijing",
    "zipcode": "100001"
  }
})";

使用nlohmann/json解析并访问字段：

#include 
#include 

using json = nlohmann::json;

int main() {
    std::string json_str = R"({"name": "Alice", "age": 25, ... })";

    try {
        json j = json::parse(json_str);

        std::cout << "Name: " << j["name"] << std::endl;
        std::cout << "Age: " << j["age"] << std::endl;
        std::cout << "Is student: " << std::boolalpha << j["is_student"] << std::endl;

        // 数组访问
        for (const auto& hobby : j["hobbies"]) {
            std::cout << "Hobby: " << hobby << std::endl;
        }

        // 对象嵌套
        std::cout << "City: " << j["address"]["city"] << std::endl;
    } catch (const json::parse_error& e) {
        std::cerr << "Parse error: " << e.what() << std::endl;
    }

    return 0;
}

序列化（对象转JSON）

可以反过来将C++变量构造成JSON对象：

json j;
j["name"] = "Bob";
j["score"] = 95.5;
j["tags"] = {"cpp", "json", "programming"};
j["meta"]["version"] = "1.0";
j["meta"]["active"] = true;

std::string output = j.dump(2); // 格式化缩进为2空格
std::cout << output << std::endl;

输出结果：

{
  "meta": {
    "active": true,
    "version": "1.0"
  },
  "name": "Bob",
  "score": 95.5,
  "tags": ["cpp", "json", "programming"]
}

结构体与JSON映射（自定义类型序列化）

可以通过定义 to_json 和 from_json 函数实现结构体与JSON互转：

struct Person {
    std::string name;
    int age;
    bool is_student;
};

void to_json(json& j, const Person& p) {
    j = json{{"name", p.name}, {"age", p.age}, {"is_student", p.is_student}};
}

void from_json(const json& j, Person& p) {
    j.at("name").get_to(p.name);
    j.at("age").get_to(p.age);
    j.at("is_student").get_to(p.is_student);
}

使用方式：

Person p = {"Tom", 20, true};
json j = p;  // 自动调用 to_json
std::cout << j.dump(2) << std::endl;

// 反向解析
Person p2 = j.get();  // 自动调用 from_json

基本上就这些常用操作。nlohmann/json语法直观，兼容STL容器，适合快速开发中处理配置、网络接口数据等场景。只要记得捕获异常、检查键是否存在，就能安全高效地使用。