c++如何将复杂嵌套结构体序列化为JSON格式存储_nlohmann库应用【附代码】-C++-PHP中文网

nlohmann::json序列化嵌套结构体需手动定义同命名空间内的to_json/from_json自由函数，从最内层结构体开始逐层实现，参数须为const引用，嵌套调用自动触发，字段名与json key严格一致。

c++如何将复杂嵌套结构体序列化为json格式存储_nlohmann库应用【附代码】

用 nlohmann::json 序列化嵌套结构体，核心不是“能不能”，而是“怎么让结构体可序列化”——它不自动反射，必须手动定义 to_json 和 from_json 两个非成员函数。

结构体必须显式声明序列化协议

nlohmann 不依赖宏或运行时反射，所有嵌套结构体都要逐层提供转换逻辑。没定义 to_json，编译直接报错：no matching function for call to 'to_json'。

每个自定义类型（包括内层结构体）都需在命名空间内声明两个自由函数：to_json 和 from_json
函数必须是 void 返回，且第二个参数为 const 引用（const T&）
不能放在类内部；若结构体在匿名命名空间里，to_json 也得在同一匿名命名空间中
嵌套越深，函数层级越要对齐：例如 A 含 B，B 含 C，那 C 的序列化必须先存在，否则 B 编译不过

嵌套结构体的 to_json 函数写法模板

以三层嵌套为例：Person → Address → GeoPoint，关键点是用 json::object() 构建键值对，字段名必须与 JSON key 一致，且类型要能被 nlohmann 自动处理（如 std::string、int、std::vector）。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

struct GeoPoint {
    double lat;
    double lng;
};

struct Address {
    std::string city;
    GeoPoint location;
};

struct Person {
    std::string name;
    int age;
    Address addr;
};

// 必须按嵌套顺序从内到外定义
void to_json(nlohmann::json& j, const GeoPoint& p) {
    j = nlohmann::json{{"lat", p.lat}, {"lng", p.lng}};
}

void to_json(nlohmann::json& j, const Address& a) {
    j = nlohmann::json{
        {"city", a.city},
        {"location", a.location}  // 自动调用 GeoPoint 的 to_json
    };
}

void to_json(nlohmann::json& j, const Person& p) {
    j = nlohmann::json{
        {"name", p.name},
        {"age", p.age},
        {"addr", p.addr}  // 自动调用 Address 的 to_json
    };
}

反序列化 from_json 容易漏掉 const 引用和异常处理

from_json 错误最常见的是忘记加 const，或没检查字段是否存在、类型是否匹配，导致运行时抛 nlohmann::json::type_error。

参数必须是 const nlohmann::json& 和 T&（非 const 引用，用于赋值）
用 j.at("key") 替代 j["key"]：前者查不到直接 throw，后者返回 null 值，后续取 .get<int>()</int> 会 crash
嵌套结构体字段也要用 .at()，比如 j.at("addr").at("location").get<geopoint>()</geopoint>
如果某些字段可选，改用 j.value("key", default_value)，但注意它不校验类型