Rust语言序列化框架详解（从零开始掌握serde：Rust序列化与反序列化的最佳实践）

第一步：添加依赖

要使用 serde，你需要在项目的 Cargo.toml 文件中添加以下依赖：

[dependencies]serde = { version = "1.0", features = ["derive"] }serde_json = "1.0"

其中：serde 是核心库，features = ["derive"] 允许我们使用 #[derive(Serialize, Deserialize)] 自动为结构体生成实现代码；serde_json 是用于处理 JSON 格式的后端。

第二步：定义可序列化的结构体

假设我们要表示一个用户信息，可以这样定义结构体：

use serde::{Serialize, Deserialize};#[derive(Serialize, Deserialize, Debug)]struct User {    id: u32,    name: String,    email: String,    active: bool,}

通过 #[derive(Serialize, Deserialize)]，Rust 编译器会自动为 User 结构体实现 Serialize 和 Deserialize trait，使其支持序列化和反序列化。

第三步：序列化为 JSON

现在我们可以将一个 User 实例转换为 JSON 字符串：

fn main() {    let user = User {        id: 101,        name: "张三".to_string(),        email: "zhangsan@example.com".to_string(),        active: true,    };    // 序列化为 JSON 字符串    let json_str = serde_json::to_string(&user).unwrap();    println!("Serialized JSON: {}", json_str);}

运行结果：

{"id":101,"name":"张三","email":"zhangsan@example.com","active":true}

第四步：从 JSON 反序列化

反过来，如果我们有一个 JSON 字符串，也可以轻松还原为 User 对象：

fn main() {    let json_data = r#"{"id":101,"name":"张三","email":"zhangsan@example.com","active":true}"#;    // 反序列化为 User 结构体    let user: User = serde_json::from_str(json_data).unwrap();    println!("Deserialized user: {:#?}", user);}

注意：这里使用了原始字符串字面量 r#"..."# 来避免转义引号。

支持更多格式：不只是 JSON

serde 的强大之处在于其可扩展性。除了 JSON，你还可以轻松切换到其他格式：

• YAML：添加 serde_yaml 依赖，使用 serde_yaml::to_string() 和 serde_yaml::from_str()
• Bincode（二进制）：高效紧凑，适合网络传输或本地缓存
• TOML：常用于配置文件

这使得 Rust数据格式转换 变得极其简单——你只需更换后端库，而无需修改数据结构本身！

常见问题与技巧

字段重命名：如果 JSON 字段名与 Rust 字段名不同，可以使用 #[serde(rename = "xxx")]：

#[derive(Serialize, Deserialize)]struct ApiResponse {    #[serde(rename = "user_id")]    id: u32,    #[serde(rename = "full_name")]    name: String,}

跳过缺失字段：使用 #[serde(default)] 可以为缺失字段提供默认值。

总结

通过本教程，你已经掌握了在 Rust 中使用 serde 进行 Rust序列化 的基本方法。无论你是处理 API 数据、保存配置，还是构建微服务，serde 都是你不可或缺的工具。记住，serde教程 的核心就是：定义结构体 → 添加 derive → 使用对应格式的函数进行转换。

赶快动手试试吧！你会发现 Rust JSON序列化 和 Rust数据格式转换 原来如此简单高效！