把 JSON 示例转换成可直接用于 serde 的 Rust struct。每个 struct 都 derive Debug, Clone, Serialize, Deserialize;字段名遵循 Rust 的 snake_case 约定,与原始 key 不同时通过 #[serde(rename)] 对应回去。
当你想让 reqwest 的响应带上类型、需要为 axum 或 actix-web 的 Json<T> 提取器准备请求类型,或者在编写解析日志、事件 JSON 的 CLI 时,它都是一个起点。
类型名 中输入顶层 struct 的名称(例如 AccessLog)。.rs 文件中,并在 Cargo.toml 中添加 serde(开启 derive 特性)和 serde_json。serde_json::from_str::<AccessLog>(&body)? 或 resp.json::<AccessLog>().await? 使用。{
"timestamp": 1714550400,
"level": "warn",
"type": "http_request",
"status": 503,
"latency_ms": 1250.7,
"headers": [{ "name": "user-agent", "value": "curl/8.4" }],
"trace_id": null
}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>。
#[derive(Debug, Clone, Serialize, Deserialize)] 和 pub 字段。#[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>;。把 ["status"].as_i64() 这样对 serde_json::Value 的查找换成 resp.json::<AccessLog>(),字段名拼错就会在编译时报错。
根据客户端发送的 JSON 生成 struct,并以 Json(payload): Json<CreateOrder> 接收;字段缺失或类型错误的请求会在处理函数代码运行之前被框架拒绝。
用一行日志生成 struct,再对 BufReader::lines() 的每一行反序列化,几行代码就能做出按字段汇总的工具。
i64。在取值范围已知的地方请自行收窄,例如状态码用 u16、计数器用 u32。i64 或 String。改用 chrono 或 time 的类型需要开启这些 crate 的 serde 特性。serde_json::Value 的输出写的是完整路径,所以不需要额外的 use,但需要 serde_json 依赖。#[serde(rename_all = "camelCase")]。如果 key 遵循统一的约定,可以自行合并。"level": "warn" 这类取值固定的字段,之后很适合改成 enum。#[serde(default)]?serde 本来就会用 None 填充缺失的 Option,但显式的 default 能保证以后把类型改成 Vec<T> 之类时,仍然接受缺失的 key。skip_serializing_if 会在写回 JSON 时省略 None 字段,保持原有的结构。
两者都会变成 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)。