Serde 用于 Rust：完整指南与示例

什么是 Serde 以及为什么需要它

Serde（Serialization/Deserialization 的缩写）是 Rust 语言中用于数据序列化和反序列化的框架。它是 Rust 生态系统中处理数据格式的事实标准。该库允许将复杂的 Rust 类型（结构体、枚举、向量、哈希表）转换为各种文本和二进制格式（JSON、YAML、TOML、BSON、MessagePack、CBOR 等），反之亦然。

Serde 的核心哲学是性能无妥协。它利用 Rust 强大的宏系统在编译阶段生成高度优化的代码，使其成为所有编程语言中最快的序列化库之一。Serde 不绑定于任何特定格式：它提供抽象的 trait Serialize 和 Deserialize，而具体格式则在独立的 crate 中实现（例如 serde_json、serde_yaml）。

为什么需要 Serde？

• 状态保存：将配置、游戏存档、缓存写入磁盘
• 网络协议：客户端与服务器之间的数据交换（REST API、WebSocket）
• 配置文件：从 JSON/YAML/TOML 读取设置
• 数据库：序列化记录以存储在 Redis、MongoDB 等数据库中
• 进程间通信：通过管道或套接字在进程之间传输数据

安装

Serde 通过 Rust 内置的包管理器 Cargo 安装。要开始使用，请在 Cargo.toml 文件中添加依赖项：

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

依赖项说明：

• serde — 库的核心，包含 trait Serialize 和 Deserialize。标志 features = ["derive"] 启用对宏 #[derive(Serialize, Deserialize)] 的支持。
• serde_json — JSON 格式的实现。类似地，可以添加 serde_yaml、serde_toml、bincode 等。

如果您使用的是 Rust 2021 edition 或更高版本，只需添加这些行即可。要安装特定版本，请指定版本号，例如 serde_json = "1.0.128"。

快速入门：第一个示例

让我们创建一个简单的结构体，将其序列化为 JSON，然后再反序列化回来：

use serde::{Deserialize, Serialize};use serde_json;

// 自动生成序列化/反序列化代码的结构体#[derive(Serialize, Deserialize, Debug)]struct User {    id: u32,    name: String,    email: String,    active: bool,}

fn main() {    // 创建结构体实例    let user = User {        id: 42,        name: "Alice".to_string(),        email: "alice@example.com".to_string(),        active: true,    };

    // 序列化为 JSON 字符串    let json_string = serde_json::to_string(&user).unwrap();    println!("序列化的 JSON: {}", json_string);

    // 反序列化回结构体    let deserialized_user: User = serde_json::from_str(&json_string).unwrap();    println!("反序列化的结构体: {:?}", deserialized_user);

    // 检查数据是否丢失    assert_eq!(user.id, deserialized_user.id);    assert_eq!(user.name, deserialized_user.name);}

程序输出：

序列化的 JSON: {"id":42,"name":"Alice","email":"alice@example.com","active":true}反序列化的结构体: User { id: 4