nlohmann/json结构体反序列化必须手动定义from_json重载函数，否则json::get()编译失败；需逐层为嵌套结构体实现该函数，字段名须与JSON键完全一致，类型需严格匹配，空值和可选字段应显式处理。
用 nlohmann/json 直接映射结构体需要手动定义 from_json
不能靠编译器自动生成，必须为每个结构体显式提供 from_json 重载函数。这是最常被忽略的前提——没写这个函数，json::get<mystruct>()</mystruct> 会编译失败，报错类似 no matching function for call to 'from_json'。
典型写法是把重载函数声明在结构体外部（或 namespace 内），并确保它和结构体在同一个作用域可见：
struct Person {
std::string name;
int age;
};
void from_json(const json& j, Person& p) {
p.name = j.at("name").get<std::string>();
p.age = j.at("age").get<int>();
}
-
j.at(key)比j[key]更安全：键不存在时抛json::out_of_range，避免静默默认值 - 如果字段可选，改用
j.value("key", default_value)，比如j.value("email", "") - 不要在
from_json里做复杂逻辑或异常转换，保持轻量；校验类逻辑建议放在构造函数或独立函数中
嵌套结构体反序列化要逐层定义 from_json
嵌套对象不会自动递归解析。比如 Person 里有个 Address 成员，你得单独为 Address 写 from_json，然后在 Person 的 from_json 里调用它。
struct Address {
std::string city;
std::string zip;
};
void from_json(const json& j, Address& a) {
a.city = j.at("city").get<std::string>();
a.zip = j.at("zip").get<std::string>();
}
void from_json(const json& j, Person& p) {
p.name = j.at("name").get<std::string>();
p.age = j.at("age").get<int>();
p.addr = j.at("address").get<Address>(); // ← 这里依赖 Address 的 from_json
}
- 数组成员同理：若
Person有std::vector<:string> hobbies</:string>，直接写p.hobbies = j.at("hobbies").get<:vector>>();</:vector> - 别试图用模板特化绕过重载——nlohmann/json 不支持泛型自动推导结构体字段
- 字段名大小写、下划线风格必须和 JSON 键完全一致，否则
at()报错
遇到 invalid type: object expected 多半是类型不匹配
这个错误通常不是 JSON 格式问题，而是 C++ 类型和 JSON 值类型对不上。比如 JSON 中 "age": "25"（字符串）但代码里用了 j.at("age").get<int>()</int>，就会触发该异常。
立即学习“C++免费学习笔记（深入）”；
- 先用
j.at("key").type()查实际类型：json::value_t::string、json::value_t::number_integer等 - 接受宽松输入？用
j.at("age").is_number()判断后再取值，或统一用get<double>()</double>再转整型 - 枚举类型需额外处理：先
get<:string>()</:string>，再查表映射，from_json里不能直接get<myenum>()</myenum> - 空值（
null）需提前检查：if (!j.at("email").is_null()) p.email = j.at("email").get<:string>();</:string>
性能敏感场景慎用 at() + 多次遍历
每次 at() 都会重新哈希查找 key，对大 JSON 或高频解析不利。如果结构体字段多且 JSON 稳定，建议一次性提取整个对象引用，再分别读取：
void from_json(const json& j, Person& p) {
const auto& obj = j.get_ref<const json::object_t&>(); // 避免拷贝
p.name = obj.at("name").get<std::string>();
p.age = obj.at("age").get<int>();
}
- 注意
get_ref<const json::object_t>()</const>返回的是 const 引用，不能用于修改 - 若 JSON 可能含多余字段，这种写法比逐个
at()更快；但失去字段缺失的早期报错能力 - 真正压测瓶颈往往不在这里，优先保证正确性和可维护性——除非 profiling 明确指出 json 解析是热点
最麻烦的从来不是怎么写 from_json，而是团队里有人忘了加它，或者改了结构体却漏掉对应函数，导致运行时报错才暴露。建议把 JSON schema 和结构体定义放一起，必要时加静态断言或单元测试覆盖字段一致性。
