Serde框架：Rust数据序列化与反序列化的终极指南

张飚贵Alarice

于 2025-06-04 09:10:42 发布

阅读量226

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/gitblog_00462/article/details/148417282

Serde框架：Rust数据序列化与反序列化的终极指南

什么是Serde？

Serde是Rust生态中最重要、使用最广泛的序列化框架之一。名称"Serde"来源于"Serialize"（序列化）和"Deserialize"（反序列化）两个词的组合。它提供了一个通用、高效的框架，用于在Rust数据结构与各种数据格式之间进行转换。

为什么需要Serde？

在软件开发中，我们经常需要：

将内存中的数据保存到文件或数据库中
通过网络传输数据
在不同系统或语言间交换数据

这些场景都需要将数据结构转换为可以存储或传输的格式（序列化），以及从这些格式还原数据结构（反序列化）。Serde正是为解决这些问题而生。

核心特性

高性能：Serde经过精心设计，序列化和反序列化操作非常高效
通用性：支持几乎所有Rust标准库中的数据类型
可扩展：通过派生宏轻松为自定义类型添加序列化能力
格式无关：核心框架与具体数据格式解耦，支持多种格式

快速入门示例

让我们通过一个简单例子了解Serde的基本用法：

use serde::{Deserialize, Serialize};

// 定义一个结构体并派生Serialize和Deserialize trait
#[derive(Serialize, Deserialize, Debug)]
struct Point {
    x: i32,
    y: i32,
}

fn main() {
    let point = Point { x: 1, y: 2 };

    // 将Point序列化为JSON字符串
    let serialized = serde_json::to_string(&point).unwrap();
    println!("序列化结果 = {}", serialized);  // 输出: {"x":1,"y":2}

    // 将JSON字符串反序列化为Point
    let deserialized: Point = serde_json::from_str(&serialized).unwrap();
    println!("反序列化结果 = {:?}", deserialized);  // 输出: Point { x: 1, y: 2 }
}

支持的数据格式

Serde通过不同的crate支持多种数据格式，包括但不限于：

JSON (serde_json)
YAML (serde_yaml)
MessagePack (rmp-serde)
TOML (toml)
BSON (bson)
XML (serde-xml-rs)
CSV (csv)

进阶用法

自定义序列化

对于需要特殊处理的情况，可以实现Serialize和Deserialize trait：

use serde::{Serializer, Deserializer};

impl Serialize for Point {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        // 自定义序列化逻辑
    }
}

字段属性控制

Serde提供了丰富的属性来控制序列化行为：

#[derive(Serialize, Deserialize)]
struct User {
    #[serde(rename = "userName")]  // 字段重命名
    name: String,
    
    #[serde(skip_serializing_if = "Option::is_none")]  // 空值跳过
    email: Option<String>,
    
    #[serde(default)]  // 反序列化时提供默认值
    age: u8,
}