推荐C++ JSON库包括JsonCpp、nlohmann/json、rapidjson和Boost.PropertyTree，其中JsonCpp因语法清晰、跨平台适合初学者。1. 安装方式多样，支持包管理器或手动编译；2. 使用Json::Value和Json::CharReaderBuilder解析JSON字符串；3. 可通过Json::StreamWriterBuilder生成格式化JSON输出；4. 注意错误处理、类型转换和字段存在性检查；5. 编译需链接-ljsoncpp。适用于中小项目，追求现代语法可选nlohmann/json，高性能场景推荐rapidjson。
在C++开发中，处理JSON数据是常见需求，比如配置文件读取、网络接口通信等。由于C++标准库不自带JSON支持，需要借助第三方库。下面推荐几个主流的C++ JSON解析库，并重点介绍 JsonCpp 的使用方法。
主流C++ JSON库推荐
以下是几个广泛使用的C++ JSON库，各有特点：- JsonCpp：老牌成熟库，语法清晰，适合初学者，支持读写JSON，跨平台。
- nlohmann/json：现代C++风格（header-only），使用体验接近Python字典，推荐新项目使用。
- rapidjson：性能高，内存占用低，支持SAX和DOM解析，适合对性能要求高的场景。
- Boost.PropertyTree：属于Boost库，可解析JSON/XML/INI等，但JSON支持较弱，不推荐复杂场景。
JsonCpp 安装与配置
在使用前需安装 JsonCpp。不同平台方式如下：-
Ubuntu/Debian：
sudo apt-get install libjsoncpp-dev -
macOS（Homebrew）：
brew install jsoncpp -
Windows + vcpkg：
vcpkg install jsoncpp - 手动编译：从 GitHub 下载源码（https://github.com/open-source-parsers/jsoncpp），用 CMake 编译安装。
JsonCpp 基本使用教程
JsonCpp 核心类是Json::Value 和 Json::Reader（旧版）或 Json::CharReader（新版）。现代版本推荐使用 Json::parseFromStream 或字符串解析。
1. 解析 JSON 字符串
示例代码：#include <iostream>
#include <json/json.h> // 注意头文件路径可能为 <jsoncpp/json/json.h>
#include <sstream>
int main() {
std::string jsonStr = R"({
"name": "Alice",
"age": 25,
"skills": ["C++", "Python"],
"address": {
"city": "Beijing",
"zipcode": "100000"
}
})";
Json::Value root;
Json::CharReaderBuilder builder;
std::string errs;
std::istringstream iss(jsonStr);
if (!parseFromStream(builder, iss, &root, &errs)) {
std::cout << "解析失败: " << errs << std::endl;
return -1;
}
std::cout << "姓名: " << root["name"].asString() << std::endl;
std::cout << "年龄: " << root["age"].asInt() << std::endl;
std::cout << "城市: " << root["address"]["city"].asString() << std::endl;
Json::Value skills = root["skills"];
for (int i = 0; i < skills.size(); ++i) {
std::cout << "技能: " << skills[i].asString() << std::endl;
}
return 0;
}
2. 构造并生成 JSON
创建 JSON 对象并输出为字符串：
Json::Value root; root["name"] = "Bob"; root["age"] = 30; root["is_student"] = false; root["scores"].append(95); root["scores"].append(87); Json::Value addr; addr["city"] = "Shanghai"; addr["street"] = "Nanjing Road"; root["address"] = addr; // 转为格式化字符串 Json::StreamWriterBuilder writerBuilder; writerBuilder["indentation"] = " "; std::string output = Json::writeString(writerBuilder, root); std::cout << output << std::endl;
常见问题与注意事项
- 旧版使用
Json::Reader，新版已废弃，应使用Json::CharReaderBuilder配合parseFromStream。 - 确保正确处理解析错误，避免程序崩溃。
- Json::Value 支持自动类型转换，但建议明确调用
asInt()、asString()等防止异常。 - 多层嵌套访问时，可用
root.isMember("key")判断字段是否存在。 - 编译时若提示找不到符号，检查是否链接了 jsoncpp 库（-ljsoncpp）。
基本上就这些。JsonCpp 上手容易，文档清晰，适合大多数中小型项目。如果追求更现代的语法，可以尝试 nlohmann/json；若强调性能，选 rapidjson。根据项目需求选择合适的工具即可。
立即学习“C++免费学习笔记（深入）”；
