C++怎么解析JSON数据 C++ JsonCpp库使用快速入门【开发】

JsonCpp是轻量易用的C++ JSON库，适合嵌入式等场景，但需注意内存管理、类型安全访问（isMember+asXxx）、正确链接、UTF-8处理及Value深拷贝陷阱。

JsonCpp 是 C++ 里最轻量、最易上手的 JSON 解析库之一，适合嵌入式、命令行工具或不需要完整生态的项目；但它的设计偏 C 风格，容易在内存管理、类型转换和错误处理上踩坑。

怎么安装 JsonCpp（Linux/macOS + CMake）

多数现代发行版已打包，优先用包管理器安装，避免手动编译出错：

• Ubuntu/Debian：sudo apt install libjsoncpp-dev，头文件自动到 /usr/include/json/json.h
• macOS（Homebrew）：brew install jsoncpp，头文件路径通常是 /opt/homebrew/include/json/json.h
• 若需静态链接或自定义构建：从 https://github.com/open-source-parsers/jsoncpp 克隆后用 cmake -DBUILD_SHARED_LIBS=OFF && make install

注意：CMakeLists.txt 中必须显式 link jsoncpp，否则链接时报 undefined reference to `Json::Value::Value(Json::ValueType)` —— 这是最常见的“装了却用不了”错误。

怎么读取字符串并提取字段（Value 类型安全访问）

Json::Value 是核心容器，但它的 [] 操作符不检查键是否存在，直接访问缺失字段会静默创建空对象，导致逻辑错误。务必用 isMember() + asXxx() 组合：

#include 
#include 

std::string json_str = R"({"name":"Alice","age":30,"active":true})";
Json::CharReaderBuilder builder;
Json::Value root;
JSONCPP_STRING errs;
if (!Json::parseFromStream(builder, std::istringstream(json_str), &root, &errs)) 
{
    std::cerr << "Parse error: " << errs << std::endl;
    return;
}

if (root.isMember("name") && root["name"].isString()) {
    std::string name = root["name"].asString(); // 安全
}
if (root.isMember("age") && root["age"].isInt()) {
    int age = root["age"].asInt(); // 不要用 asUInt() 除非确定非负
}
// ❌ 错误写法：int age = root["age"].asInt(); // 缺少 isMember/isInt 检查，可能返回 0 误导逻辑

怎么生成 JSON 字符串（避免中文乱码和格式控制）

默认 Json::StreamWriterBuilder 输出无缩进、无换行，且对 UTF-8 字符串不做转义 —— 如果输入含中文，直接输出是正常的；但若原始字符串是 GBK 或其他编码，需先转 UTF-8 再塞进 Json::Value。

• 要美化输出（带缩进）：设置 builder["indentation"] = " ";
• 要禁止转义 Unicode（让中文原样显示而非 \u4f60）：设置 builder["emitUTF8"] = true;
• 要生成紧凑格式（如 HTTP body）：保持默认，或设 builder["indentation"] = "";

示例：

Json::StreamWriterBuilder builder;
builder["indentation"] = "  ";
builder["emitUTF8"] = true;
std::string output = Json::writeString(builder, root);

常见崩溃点：Value 生命周期与深拷贝陷阱

Json::Value 默认是浅拷贝语义，但内部引用计数管理较隐晦。以下操作极易引发 double-free 或悬空引用：

• 把局部 Json::Value 的引用（Json::Value&）存入容器或返回给调用方 —— 函数退出后引用失效
• 用 operator= 赋值后，原对象仍持有部分资源，尤其在频繁增删字段时
• 混用 Json::Value 和 Json::Value*，又忘了 delete（它不是智能指针）

稳妥做法：始终按值传递 Json::Value，或明确使用 std::unique_ptr<:value> 管理动态分配对象；解析后立即转成业务结构体，别长期持有 Json::Value 实例。