C++无标准自动struct转JSON方案，必须显式定义to_json/from_json函数；nlohmann/json通过ADL简化但非真正自动，依赖命名空间内自由函数、聚合类型限制及手动处理私有成员与复杂类型。
struct 转 JSON 没有标准自动方案
标准 C++ 不提供任何自动序列化机制，struct 到 json 的转换必须显式定义字段映射关系。你不能只写个 struct 就指望编译器生成 JSON；不加干预，连字段名都拿不到。
用 nlohmann/json 最接近“自动”的写法
nlohmann/json 支持 ADL（Argument-Dependent Lookup）自定义序列化，配合宏或模板能减少重复代码，但依然需要你为每个 struct 显式声明如何转 —— 它只是把 to_json/from_json 的样板逻辑收拢了。
常见错误现象：error: no matching function for call to 'to_json'，通常是因为没在 struct 同一命名空间里定义 to_json 函数，或者忘了加 using json = nlohmann::json;。
- 必须在
struct所在命名空间内定义自由函数to_json(json&, const YourStruct&) - 字段顺序不保证和结构体声明一致（JSON 对象无序），别依赖输出字符串的字段排列
- 不支持私有成员直接访问；若需序列化私有字段，得设为
friend或提供公有 getter - 示例：
struct Person { std::string name; int age; }; void to_json(nlohmann::json& j, const Person& p) { j = nlohmann::json{{"name", p.name}, {"age", p.age}}; }
反射缺失导致的硬伤：无法真正“自动”
C++17/20 仍无运行时类型反射，编译期反射（如 P1240、P2320）尚未落地。所有号称“零配置”的库（如 magic_get、boost.pfr）本质都是通过模板元编程在编译期枚举字段，但它们有严格限制：
立即学习“C++免费学习笔记（深入）”；
-
boost::pfr::structure_to_tuple要求struct是普通聚合类型（no user-defined ctor, no private members, no base classes） - 字段类型必须可 JSON 序列化；比如
std::vector<:unique_ptr>></:unique_ptr>就得自己处理，boost.pfr不会帮你递归展开 - Windows 上 MSVC 对模板深度敏感，复杂嵌套
struct可能触发C1060: compiler is out of heap space - 跨平台注意：Clang 和 GCC 对非静态数据成员初始化（NSDMI）+ 结构体反射的兼容性略有差异
生产环境建议：明确控制比“自动”更可靠
真实项目中，JSON schema 往往受协议约束（如 API 文档、后端约定），字段名可能和 C++ 成员名不一致，还常带条件序列化（如仅当 status == ACTIVE 才输出 reason 字段）。这时候硬套“自动”反而增加调试成本。
- 优先手写
to_json：字段名、默认值、空值处理、嵌套逻辑全在掌控中 - 用
static_assert检查字段存在性，比如static_assert(std::is_same_v<decltype std::string>);</decltype> - 避免把
std::optional<t></t>直接塞进 JSON 对象 —— nlohmann 默认序列化为null，但前端可能期望完全省略该 key，得手动判断 - 如果结构体极多且高度同质（如配置项），再考虑用 Python 脚本解析头文件生成序列化代码，而不是在 C++ 里强行“泛化”
最易被忽略的一点：JSON 键名是字符串字面量，拼错一个字母，运行时才暴露，编译器拦不住。与其赌反射库的完备性，不如让字段映射关系清清楚楚落在代码里。
