operator[]添加成员最常用但需类型匹配,支持链式嵌套赋值;emplace和insert适合避免临时对象开销;数组添加元素必须用push_back或emplace_back,不可混用对象操作;中文键名应显式用utf-8编码的std::string构造。

用 operator[] 添加成员最常用,但类型必须匹配
直接用方括号赋值是最直观的方式,比如 json_obj["name"] = "Alice"。但要注意:json_obj 必须是 json 类型(如 nlohmann::json),且左侧键名必须是字符串字面量或 std::string,不能是 const char* 以外的其他指针类型。如果 json_obj 是 nullptr 或未初始化,会触发断言失败或未定义行为。
- 支持的右值类型包括
int、double、std::string、bool、nlohmann::json对象、数组等 - 若键已存在,会覆盖原值;若不存在,则新增
- 对嵌套对象,可链式调用:
json_obj["user"]["profile"]["age"] = 30,中间路径会自动创建为对象
emplace 和 insert 适合避免临时对象开销
当右值构造成本高(比如大字符串或复杂子对象)时,emplace 能就地构造,比 operator[] 少一次拷贝。nlohmann::json 支持 emplace(key, args...) 形式,例如:json_obj.emplace("data", std::vector<int>{1,2,3})</int>。
-
insert接受std::pair,适用于批量插入或需检查是否插入成功:auto res = json_obj.insert({"count", 42});,返回std::pair<iterator bool></iterator>,res.second表示是否新增 -
emplace不检查键是否存在,行为等同于operator[]赋值,但更高效 - 二者都不支持链式嵌套路径自动创建,只作用于顶层键
向数组添加元素不是“添加成员”,别混用 push_back
JSON 对象(object)和数组(array)是不同类型。给对象加字段用 operator[],给数组加元素得用 push_back 或 emplace_back。常见错误是把数组误当成对象操作:json_arr["item"] = 123 会报错或静默失败(取决于库版本)。
使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 确认类型:用
json_obj.is_object()或json_obj.is_array()判断 - 数组追加:
json_arr.push_back("new_item")或json_arr.emplace_back(42) - 想在对象里存数组?先确保字段是对象:
json_obj["items"] = nlohmann::json::array();,再用json_obj["items"].push_back(...)
中文键名、特殊字符、空格键要加引号,别依赖裸字面量
像 "用户信息"、"is-active"、"key with space" 这类键名,C++ 字符串字面量本身没问题,但容易因编码或 IDE 设置引发乱码。更稳妥的是显式用 std::string 构造:
json_obj[std::string(u8"用户信息")] = "张三";
- 裸字面量
"用户信息"在源文件编码与编译器默认不一致时可能出错(尤其 Windows MSVC 默认 GBK) - 避免用宏或拼接字符串作键名,编译期无法检查合法性
- 键名中含控制字符(如
\0、换行)会导致序列化异常,建议提前过滤或拒绝
实际写的时候,键名尽量用 ASCII 命名,真要支持 Unicode 就统一用 UTF-8 编码的 std::string,并确保整个工程编码一致。否则序列化后 JSON 文件看起来是乱码,但解析时又可能侥幸成功——这种问题最难定位。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










