C++如何解析JSON数据？jsoncpp库在C++中的使用方法【数据交互】

冰火之心 2025-12-13 00:00:00 次阅读

JsonCpp解析JSON需先安装库并链接-ljsoncpp，包含头文件；用Json::CharReaderBuilder和parseFromStream安全解析字符串为Json::Value对象。

用 JsonCpp 解析 JSON 数据在 C++ 中很常见，关键是把 JSON 字符串转成可操作的结构体（Json::Value），再按需提取字段。它轻量、易集成，适合大多数本地数据交互场景。

安装与基础配置

Linux 下常用包管理器安装：

Ubuntu/Debian：sudo apt install libjsoncpp-dev
macOS（Homebrew）：brew install jsoncpp
Windows 推荐用 vcpkg：vcpkg install jsoncpp

编译时链接库：g++ main.cpp -ljsoncpp；头文件只需包含 #include 。

解析 JSON 字符串

用 Json::CharReaderBuilder 和 parse() 安全读取字符串：

std::string jsonStr = R"({"name":"Alice","age":30,"hobbies":["reading","coding"]})";
Json::Value root;
Json::CharReaderBuilder builder;
JSONCPP_STRING errs;
std::istringstream iss(jsonStr);
if (!Json::parseFromStream(builder, iss, &root, &errs)) {
    std::cerr << "解析失败：" << errs << std::endl;
    return -1;
}

成功后 root 就是整个 JSON 的根节点，支持链式访问。

提取字段值（安全写法）

避免崩溃的关键：始终检查字段是否存在、类型是否匹配：

if (root.isMember("name") && root["name"].isString()) → 取字符串
if (root.isMember("age") && root["age"].isInt()) → 取整数
if (root.isMember("hobbies") && root["hobbies"].isArray()) → 遍历数组

例如遍历 hobbies：

const Json::Value& hobbies = root["hobbies"];
for (const auto& item : hobbies) {
    if (item.isString()) {
        std::cout << item.asString() << std::endl;
    }
}

生成 JSON 字符串（反向操作）

构建对象后，用 Json::StreamWriterBuilder 转为字符串：

Json::Value out;
out["code"] = 200;
out["msg"] = "success";
out["data"]["user_id"] = 123;

Json::StreamWriterBuilder builder;
std::string output = Json::writeString(builder, out); // 得到格式化 JSON 字符串

如需紧凑输出（无空格换行），设置 builder["indentation"] = "";。

基本上就这些。JsonCpp 不复杂但容易忽略类型检查和错误处理，实际项目中建议封装一层简单 wrapper 来统一处理解析失败和默认值回退。