推荐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#include // 注意头文件路径可能为 #include 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::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++免费学习笔记(深入)”;











