将 JSON 转换为 Rust struct!

输入 JSON,即可生成包含嵌套对象的 Rust struct 代码!支持 serde Serialize, Deserialize, #[serde(rename)]。
JSON
结果
 

将 JSON 转换为 Rust struct!

把 JSON 示例转换成可直接用于 serde 的 Rust struct。每个 struct 都 derive Debug, Clone, Serialize, Deserialize;字段名遵循 Rust 的 snake_case 约定,与原始 key 不同时通过 #[serde(rename)] 对应回去。

当你想让 reqwest 的响应带上类型、需要为 axum 或 actix-web 的 Json<T> 提取器准备请求类型,或者在编写解析日志、事件 JSON 的 CLI 时,它都是一个起点。

使用方法

  1. 粘贴 JSON。包含多个元素的数组有助于识别可选字段。
  2. 在 类型名 中输入顶层 struct 的名称(例如 AccessLog)。
  3. 把输出粘贴到 .rs 文件中,并在 Cargo.toml 中添加 serde(开启 derive 特性)和 serde_json。
  4. 通过 serde_json::from_str::<AccessLog>(&body)? 或 resp.json::<AccessLog>().await? 使用。

示例

输入 (JSON)
{
  "timestamp": 1714550400,
  "level": "warn",
  "type": "http_request",
  "status": 503,
  "latency_ms": 1250.7,
  "headers": [{ "name": "user-agent", "value": "curl/8.4" }],
  "trace_id": null
}
输出 (Rust · serde)
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AccessLog {
    pub timestamp: i64,
    pub level: String,
    #[serde(rename = "type")]
    pub type_: String,
    pub status: i64,
    pub latency_ms: f64,
    pub headers: Vec<Header>,
    pub trace_id: serde_json::Value,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Header {
    pub name: String,
    pub value: String,
}

type 是 Rust 关键字,所以字段名为 type_ 并带有 #[serde(rename = "type")]。整数不论大小都是 i64,latency_ms 是 f64。trace_id 始终是 null,类型未知,因此保留为 serde_json::Value;请换成真实类型,例如 Option<String>。

支持的功能

  • 每个 struct 都有 #[derive(Debug, Clone, Serialize, Deserialize)] 和 pub 字段。
  • 当 key 与 snake_case 字段名不同时,为该字段加上 #[serde(rename = "originalKey")]。
  • 在部分元素中缺失的字段:Option<T>,并带 #[serde(default, skip_serializing_if = "Option::is_none")]。
  • 始终存在但有时为 null 的字段:不带属性的普通 Option<T>。
  • 类型:整数为 i64,小数为 f64,bool、String、Vec<T>,混合类型为 serde_json::Value。
  • type、match、ref 等关键字 key 会加上后缀下划线(type_)。
  • 顶层为数组时生成 pub type Root = Vec<RootItem>;。

使用场景

带类型的 reqwest 响应

把 ["status"].as_i64() 这样对 serde_json::Value 的查找换成 resp.json::<AccessLog>(),字段名拼错就会在编译时报错。

axum 或 actix-web 中的请求体

根据客户端发送的 JSON 生成 struct,并以 Json(payload): Json<CreateOrder> 接收;字段缺失或类型错误的请求会在处理函数代码运行之前被框架拒绝。

分析 JSON Lines 日志的 CLI

用一行日志生成 struct,再对 BufReader::lines() 的每一行反序列化,几行代码就能做出按字段汇总的工具。

注意事项与限制

  • 整数无论多小都是 i64。在取值范围已知的地方请自行收窄,例如状态码用 u16、计数器用 u32。
  • 时间戳和日期字符串仍是 i64 或 String。改用 chrono 或 time 的类型需要开启这些 crate 的 serde 特性。
  • 用到 serde_json::Value 的输出写的是完整路径,所以不需要额外的 use,但需要 serde_json 依赖。
  • 重命名是按字段进行的,而不是在 struct 级别使用 #[serde(rename_all = "camelCase")]。如果 key 遵循统一的约定,可以自行合并。
  • 不会生成带标签的 enum。"level": "warn" 这类取值固定的字段,之后很适合改成 enum。

常见问题

为什么可选字段还要加 #[serde(default)]?

serde 本来就会用 None 填充缺失的 Option,但显式的 default 能保证以后把类型改成 Vec<T> 之类时,仍然接受缺失的 key。skip_serializing_if 会在写回 JSON 时省略 None 字段,保持原有的结构。

可能为 null 的字段和可能缺失的字段,在输出中有什么区别?

两者都会变成 Option<T>,但只有 key 可能不存在的字段才会带上 default 和 skip_serializing_if 属性。始终存在但有时为 null 的字段,写回时仍是 null。

为什么不用 &str 字段和 'de 生命周期来借用?

零拷贝字段(&'a str)的生命周期不能超过输入缓冲区,这在常见的响应处理中很不方便。默认使用拥有所有权的 String;如果性能很重要,再把热点字段换成 Cow<'a, str>。

能加上 Default 或 PartialEq 的 derive 吗?

输出只 derive Debug、Clone、Serialize 和 Deserialize。当所有字段类型都支持时,可以自行往 derive 列表里添加(serde_json::Value 实现了 PartialEq)。