先选库:三个选项按项目定
生成 C++ 结构体的第一个决策不是点按钮,是选 JSON 库——它决定生成的代码形态(以本站 JSON 转 C++ 转换器 为例):
| 你的项目 | 选什么 | 为什么 |
|---|---|---|
| 新项目、无特殊性能要求 | nlohmann/json(推荐默认) | API 最像写 Python,异常语义清晰,单头文件引入,宏生态全 |
| 解析性能敏感(高频大报文) | RapidJSON | SAX 风格零分配解析快,代价是 API 繁琐、内存自己管 |
| 已在 Boost 生态 | Boost.JSON | 与 Boost.Asio 等协同顺,少一个依赖 |
配套选项:C++ 标准(11/14/17/20,按工程实际——17 起才有 std::optional,选 11 会退化)、命名风格(camelCase/snake_case 跟团队规范)、命名空间与结构体名按工程填。注释和 getter/setter 可选生成。
类型推断规则与五个盲区
生成器按样本推断类型,规则与盲区都在这张表里:
| JSON 值 | 推断的 C++ 类型 | 盲区 |
|---|---|---|
42 |
int |
32 位上限——13 位时间戳溢出,手改 int64_t |
3.14 |
double |
金额别用浮点,定点存分 |
"text" |
std::string |
— |
true |
bool |
— |
null |
std::optional<std::string> |
语义是「不知道类型,按字符串兜底」——真实类型可能是数字,按文档改 |
[] |
std::vector<std::string> |
空数组推不出元素类型,默认字符串——按文档改成真实类型 |
[1, 2] |
std::vector<int> |
只看首元素——[1, "a"] 会推成 vector<int>,混合数组是接口设计问题 |
{...} |
nlohmann::json |
动态类型承接,不生成子结构体——见下节 |
最重要的边界:嵌套对象不展开成子 struct。 生成器把嵌套对象的字段类型直接给 nlohmann::json——任何嵌套结构都能兜住、不会推错,但嵌套字段失去编译期类型检查,访问走 json["key"] 运行时路径。想要强类型嵌套,把子对象单独贴进来再生成一次、手动组装——层级稳定的接口值得,结构多变的响应用动态类型反而省心。
序列化宏:生成代码的维护点
选 nlohmann 时会生成 NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(StructName, field1, field2, ...)——这个宏为你的 struct 自动生成 to_json/from_json,struct 与 JSON 互转就有了。
绑定关系要记牢:宏里的字段列表必须与 struct 成员完全一致。三种常见翻车:
- 加了字段忘了改宏——序列化静默漏字段;
- 切换命名风格(camelCase→snake_case)——struct 成员变了,宏里的列表要同步;
- 字段改名——宏里旧名编译不过,是好事,至少不静默。
验证:两段式
生成的代码分两段,验证方式不同:
- 纯 struct 段(字段定义,零依赖的标准 C++):直接贴进 C++ 在线编译器 跑个 main——打印
sizeof(Struct)和各字段,布局、对齐、拼写一眼验证; - 序列化段(宏 + nlohmann 依赖):本地工程编译,跑一次往返(struct→json→struct 比对字段),比肉眼看宏可靠。
真话:生成的 struct 是起点
- 样本决定类型:推断只看你贴的那份 JSON——null 字段、空数组、嵌套对象全是「信息不足」的信号,拿接口文档或多份真实样本校一遍再进工程;
- int 溢出是 C++ 版独有的坑:Java 至少还有 Long 兜着,C++ 的 int 是 32 位——ID 与时间戳字段过一遍是必要收尾;
- 混合类型数组回去找接口方:
[1, "a"]推成vector<int>编译没问题、运行时才炸——这类接口本身该修,不是 C++ 侧硬扛。
常见问题
为什么嵌套对象的字段类型是 nlohmann::json,而不是子结构体?
生成器对嵌套对象的处理是「动态承接」:字段类型直接给 nlohmann::json,序列化时整个子树原样进出——好处是任何嵌套结构都能处理;代价是嵌套字段失去编译期类型检查。想要强类型的嵌套子结构体,把子对象单独贴进来再生成一次、手动组装——对层级稳定的接口值得,对结构多变的响应动态类型反而省心。
13 位时间戳这样的整数字段怎么办?
生成器看到整数一律推成 int——C++ 的 int 通常是 32 位,上限约 21.4 亿,13 位毫秒时间戳、雪花 ID 全部溢出。规则:JSON 里超过 10 位的整数一律手改成 int64_t。顺手检查相邻字段——created_at 和 updated_at 通常是同一种类型。金额字段同理别用 double,定点存分比浮点稳。
生成的 struct 怎么快速验证对不对?
纯 struct 部分是标准 C++、零依赖——直接贴进在线 C++ 编译器跑一个 main,打印 sizeof 和各字段的值,布局、对齐、字段名拼写一眼验证。带 NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE 宏的完整代码依赖 nlohmann 头文件,本地工程编译跑一次序列化往返比对最实在。
NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE 宏是什么,改字段时要动哪里?
它是 nlohmann/json 提供的宏,为你的 struct 自动生成 to_json/from_json 转换函数——只需在宏里列出字段名。NON_INTRUSIVE 指不侵入 struct 定义。关键绑定关系:宏里的字段名列表必须与 struct 成员完全一致——加了字段不改宏会静默漏字段;切换命名风格后宏里的旧名字也要同步。