用nlohmann::json读取嵌套对象和数组应优先使用at()安全访问并配合is_object()/is_array()类型检查,缺失字段用contains()判断或封装get_or()函数处理,默认值需注意类型匹配,性能敏感时用get_ref避免拷贝。
如何用 nlohmann::json 读取嵌套对象和数组
nlohmann 库把 JSON 当作树形结构处理,嵌套对象就是 json 类型的值,不是字符串或原始指针。直接用 operator[] 可以链式访问,但必须确保每层键都存在,否则会静默创建空对象(导致逻辑错误)。
推荐用 at() 替代 operator[] 做安全访问——它在键不存在时抛出 nlohmann::json::out_of_range 异常,便于定位问题:
json j = R"({"user":{"profile":{"name":"Alice","tags":["dev","cpp"]}}})"_json;
try {
std::string name = j.at("user").at("profile").at("name").get();
auto tags = j.at("user").at("profile").at("tags").get<std::vector>();
} catch (const json::out_of_range& e) {
// 处理缺失字段
}
-
at()是只读、安全、带异常检查的访问方式;operator[]是可写、自动补缺、无提示的访问方式 - 嵌套过深时,建议拆成中间变量,避免长链调用掩盖哪一层出错
- 对不确定是否存在的字段,先用
contains()判断再访问,比 try/catch 更轻量
解析动态结构:如何判断某个嵌套节点是 object 还是 array
JSON 数据可能在运行时变化结构(比如 API 返回中 data 有时是对象、有时是数组),不能硬写 .at("data").get() 后直接当对象用。
必须用 is_object()、is_array()、is_string() 等类型检查函数预先判断:
立即学习“C++免费学习笔记(深入)”;
json data_node = j.at("data");
if (data_node.is_object()) {
// 解析为单个对象
int id = data_node.at("id").get();
} else if (data_node.is_array()) {
// 解析为对象数组
for (const auto& item : data_node) {
if (item.is_object() && item.contains("id")) {
std::cout << item.at("id").get() << "\n";
}
}
}
- 不要依赖
dump()输出字符串去匹配关键字判断类型,效率低且易错 -
is_null()必须显式检查,尤其在可选字段为空时,否则at()会抛异常 - 类型检查后,再用
get()转换,避免bad_cast
处理缺失字段与默认值的惯用写法
nlohmann 不提供类似 JavaScript 的 ?. 或 Python 的 dict.get("key", default) 语法,但可以用逻辑短路 + 三元表达式模拟: