nlohmann/json 直接映射 struct 最省事，依赖 adl 自动识别 from_json/to_json，要求字段名与类型严格匹配；字段名不一致或需类型转换时须手动实现 from_json，常见错误为拼写、大小写、缺失字段或私有成员未提供解析函数。
用 nlohmann/json 直接映射到 struct，别手写解析器
直接用 nlohmann::json 的结构体序列化支持是最省事的方案。它通过 ADL（Argument-Dependent Lookup）自动识别 from_json 和 to_json 函数，无需反射或宏。前提是你的 struct 成员名和 JSON 字段名严格一致，且类型可直接转换（比如 int ↔ JSON number、std::string ↔ JSON string）。
常见错误现象：nlohmann::json::parse 成功但 json.get<yourstruct>()</yourstruct> 报 type_error 或 out_of_range —— 多半是字段名拼错、大小写不匹配，或某个字段在 JSON 中缺失但 struct 成员没设默认值。
- struct 必须定义在命名空间内（推荐），且不能有私有成员（除非显式提供
from_json） - 支持嵌套 struct，只要嵌套类型也满足上述规则
- 可选字段用
std::optional<t></t>，JSON 中缺失时自动为std::nullopt - 数组对应
std::vector<t></t>，对象对应std::map<:string t></:string>或 struct
// 示例：定义可自动解析的 struct
struct Person {
std::string name;
int age;
std::optional<:string> email;
};
<p>// 必须提供 ADL 友元函数（放在 struct 内部或同命名空间）
void from_json(const nlohmann::json& j, Person& p) {
j.at("name").get_to(p.name);
j.at("age").get_to(p.age);
if (j.contains("email")) j.at("email").get_to(p.email);
}
</p></:string>
字段名不一致或需类型转换时，必须手动写 from_json
JSON 字段是 user_id，C++ 成员是 user_id_；或者 JSON 里是字符串 "2024-01-01"，你要转成 std::chrono::system_clock::time_point —— 这类情况无法靠自动映射，必须显式实现 from_json。重点不是“能不能做”，而是“在哪写、怎么写才不踩坑”。
使用场景：对接外部 API（字段命名风格不统一）、历史数据兼容（字段类型变更）、需要校验或默认值填充。
- 别在
from_json里 throw 异常来表示缺失字段——nlohmann::json默认抛nlohmann::json::out_of_range，你 catch 后再包装反而掩盖原始位置信息 - 用
j.at("key")表示该字段必须存在；用j.value("key", default)表示可选且有默认值 - 避免重复调用
j["key"]，因为每次都是 O(log n) 查找；先存为局部变量 - 如果要支持部分字段缺失就构造成功（宽松模式），用
j.find("key") != j.end()判断再赋值
解析失败时，错误信息太模糊？加一层 try-catch 并打印原始 JSON 片段
nlohmann::json::parse 报 [json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value 这类信息对定位问题帮助有限。真正卡住的往往是 JSON 本身不合法（比如末尾多逗号、单引号代替双引号、BOM 字节残留），而不是 C++ 层逻辑。
实操建议：
- 先用
std::string_view截取报错位置前后 20 字符，打印出来比看整段 JSON 更快 - 检查输入是否含不可见字符：
for (auto c : json_str) if (c - 用在线 JSON 校验工具（如 jsonlint.com）粘贴原始字符串验证，排除编码或格式问题
- 不要依赖
json.is_null()或json.empty()判断解析失败——它们只在解析成功后有意义；失败时json对象处于未定义状态
性能敏感场景：避免反复解析同一 JSON 字符串
如果你在循环里对同一个 std::string 调用 nlohmann::json::parse 十几次，CPU 时间会明显花在 tokenizer 上。这不是 bug，但属于可优化的惯性写法。
关键点：
- 把
nlohmann::json对象缓存起来，复用其内部 parsed tree，而不是每次重新 parse 字符串 - 如果只取其中几个字段，用
json["field"].get<int>()</int>比先get<yourstruct>()</yourstruct>再取成员更快（避免构造整个 struct） - 编译时加
-DNLOHMANN_JSON_USE_IMPLICIT_CONVERSIONS=0可禁用隐式转换，减少模板膨胀和潜在歧义 - Release 模式下
nlohmann::json解析速度通常够用；真瓶颈在 I/O 或网络层，而非解析器本身
最常被忽略的是：把 JSON 字符串从文件读入后，直接传给 parse —— 如果文件含 UTF-8 BOM（EF BB BF），会导致解析失败，但错误提示完全不提 BOM。得自己 strip。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
