RapidJSON for C++：完整指南与示例

RapidJSON 是一个用于 C++ 语言的高性能 JSON 解析与生成库。由 Milo Yip 开发并在 MIT 许可下发布，它因其速度、极低的内存消耗以及完全符合 ECMA-404 (RFC 7159) 标准而广受欢迎。与许多其他库不同，RapidJSON 不需要外部依赖，并且可以在资源受限的环境中运行，包括嵌入式系统。

为什么需要这个库？JSON（JavaScript Object Notation）已成为 Web 服务之间数据交换、配置文件以及结构化数据存储的事实标准。在性能至关重要的 C++ 中，使用慢速解析器可能成为瓶颈。RapidJSON 解决了这个问题：它能够在毫秒内处理兆字节的 JSON，使用类似 SAX（流式）API 来最小化内存分配，并使用 DOM API 方便地操作对象树。这使其成为高负载服务器、游戏引擎和实时应用的理想选择。

该库支持完整的 JSON 解析（含正确性校验）以及用于加速的“宽松”模式。它能够处理 UTF-8、UTF-16 和 UTF-32，并提供便捷的迭代器和搜索功能。RapidJSON 被广泛应用于 MongoDB、腾讯以及许多开源项目中。

安装

RapidJSON 是一个 header-only 库（除了一些可选的构建文件外）。这意味着要使用它，只需将头文件复制到您的项目中并包含它们即可。但为方便起见，我们将介绍三种主要的安装方法。

方法 1：克隆仓库（推荐）

从 GitHub 克隆仓库，并将 include/rapidjson 文件夹复制到您的项目中。

git clone https://github.com/Tencent/rapidjson.git\n# 然后将 include/rapidjson 文件夹复制到您的项目中

方法 2：通过 vcpkg 包管理器

如果您使用 vcpkg，只需一条命令即可安装：

vcpkg install rapidjson

方法 3：通过 Conan

对于 Conan（C/C++ 包管理器）用户：

conan install rapidjson/1.1.0@

在代码中引用

安装后，在您的源文件中添加：

#include "rapidjson/document.h"     // 用于 DOM API\n#include "rapidjson/writer.h"       // 用于写入 JSON\n#include "rapidjson/stringbuffer.h" // 用于输出缓冲\n#include "rapidjson/prettywriter.h" // 用于格式化输出\n#include "rapidjson/reader.h"       // 用于 SAX API\n#include "rapidjson/error/en.h"     // 用于错误处理

快速入门：最小工作示例

让我们编写一个最简单的程序，解析 JSON 字符串，提取值并输出到屏幕。

#include <iostream>\n#include "rapidjson/document.h"\n\nint main() {\n    // 1. 要解析的 JSON 字符串\n    const char* json = "{\\"project\\":\\"RapidJSON\\",\\"version\\":1.0}";\n\n    // 2. 创建 DOM 文档\n    rapidjson::Document doc;\n    doc.Parse(json);\n\n    // 3. 检查解析是否成功\n    if (doc.HasParseError()) {\n        std::cerr << "解析错误: " \n                  << rapidjson::GetParseError_En(doc.GetParseError()) \n                  << std::endl;\n        return 1;\n    }\n\n    // 4. 按键提取值\n    const std::string& project = doc["project"].GetString();\n    double version = doc["version"].GetDouble();\n\n    // 5. 输出结果\n    std::cout << "项目: " << project << std::endl;\n    std::cout << "版本: "