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() 组合：
立即学习“C++免费学习笔记（深入）”；
Evez Github Manager
下载
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
#include <json/json.h>
#include <iostream>
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<Json::Value> 管理动态分配对象；解析后立即转成业务结构体，别长期持有 Json::Value 实例。
