C++如何解析JSON数据_C++常用JSON库RapidJSON与JsonCpp使用教程

RapidJSON和JsonCpp是C++中处理JSON的主流库，前者高性能适合高频场景，后者API简洁易用适合快速开发。

在C++开发中，处理JSON数据是常见需求，尤其在与Web服务交互、配置文件读取或数据序列化时。由于C++标准库未内置JSON支持，开发者通常依赖第三方库来解析和生成JSON。本文重点介绍两个广泛使用的C++ JSON库：RapidJSON 和 JsonCpp，并提供基本使用方法。

选择合适的JSON库

目前主流的C++ JSON库中，RapidJSON 以高性能著称，支持SAX和DOM两种解析模式，适合对性能要求较高的场景；JsonCpp 使用简单，API设计清晰，适合快速开发和中小型项目。两者均为头文件为主（header-only）或轻量级链接库，易于集成到项目中。

RapidJSON 基本使用

RapidJSON 是一个极快的C++ JSON解析器和生成器，由Tencent开源，支持C++11，无需依赖外部库。

1. 安装与包含头文件
从GitHub获取 RapidJSON 源码并放入项目 include 目录，或通过包管理器安装。使用时只需包含头文件：

#include "rapidjson/document.h"

#include "rapidjson/writer.h"

#include "rapidjson/stringbuffer.h"

2. 解析JSON字符串
以下示例展示如何解析一段JSON并访问字段：

#include 

#include "rapidjson/document.h"

using namespace rapidjson;
int main() {

    const char* json = R"({"name": "Alice", "age": 25, "city": "Beijing"})";

    Document doc;

    doc.Parse(json);
    if (doc.HasParseError()) {

        std::cerr << "JSON解析错误";

        return -1;

    }

    if (doc.IsObject()) {

        std::cout << "Name: " << doc["name"].GetString() << "\n";

        std::cout << "Age: " << doc["age"].GetInt() << "\n";

    }
    return 0;

}

3. 构造JSON对象
使用 Value 和 Document 构建JSON：

Document doc;

doc.SetObject();

auto& allocator = doc.GetAllocator();
doc.AddMember("name", "Bob", allocator);

doc.AddMember("age", 30, allocator);
Value city(kStringType);

city.SetString("Shanghai", allocator);

doc.AddMember("city", city, allocator);
StringBuffer buffer;

Writer writer(buffer);

doc.Accept(writer);

std::cout << buffer.GetString() << std::endl; // 输出: {"name":"Bob","age":30,"city":"Shanghai"}

JsonCpp 基本使用

JsonCpp 是另一个流行的C++ JSON库，API简洁，适合初学者。

1. 安装与包含头文件
可通过 vcpkg、apt 或源码编译安装。使用时包含：

#include

2. 解析JSON字符串
示例如下：

#include 

#include 

#include 
int main() {

    std::string json = R"({"title": "C++ Tutorial", "pages": 350, "inStock": true})";

    Json::Value root;

    Json::CharReaderBuilder builder;

    std::string errs;
    std::istringstream iss(json);

    if (!parseFromStream(builder, iss, &root, &errs)) {

        std::cerr << "解析失败: " << errs;

        return -1;

    }
    std::cout << "Title: " << root["title"].asString() << "\n";

    std::cout << "Pages: " << root["pages"].asInt() << "\n";

    std::cout << "In Stock: " << (root["inStock"].asBool() ? "Yes" : "No") << "\n";
    return 0;

}

3. 创建JSON对象

Json::Value book;

book["title"] = "Effective C++";

book["pages"] = 400;

book["inStock"] = true;
Json::StreamWriterBuilder writer;

writer["indentation"] = "  ";

std::string output = Json::writeString(writer, book);

std::cout << output << std::endl; // 格式化输出

性能与适用场景对比

RapidJSON 解析速度更快，内存占用更小，适合高频数据交换场景如游戏服务器、实时通信。JsonCpp API 更直观，学习成本低，适合配置解析或小型工具开发。项目中可根据团队熟悉度和性能要求选择。

基本上就这些。掌握这两个库的基本用法，足以应对大多数C++中的JSON处理任务。