异步与网络

第27课：序列化

🎯 本课目标

掌握Serde序列化框架：JSON/二进制序列化、自定义序列化和派生宏。

1. Serde基础

use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize, Debug)]
struct User {
    name: String,
    age: u32,
    // 重命名字段
    #[serde(rename = "emailAddress")]
    email: String,
    // 可选字段（缺失时为None）
    #[serde(default)]
    phone: Option<String>,
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let user = User {
        name: "Alice".into(),
        age: 30,
        email: "alice@ex.com".into(),
        phone: None,
    };

    // 序列化 → JSON
    let json = serde_json::to_string(&user)?;
    println!("JSON: {}", json);

    // 美化输出
    let pretty = serde_json::to_string_pretty(&user)?;

    // 反序列化 ← JSON
    let parsed: User = serde_json::from_str(&json)?;
    println!("解析: {:?}", parsed);

    Ok(())
}

✅ 编译验证通过

2. Serde属性

#[derive(Serialize, Deserialize)]
struct Config {
    // 重命名
    #[serde(rename = "apiKey")]
    api_key: String,

    // 跳过序列化
    #[serde(skip_serializing)]
    password: String,

    // 默认值
    #[serde(default = "default_port")]
    port: u16,

    // 自定义序列化器
    #[serde(serialize_with = "serialize_duration")]
    timeout: std::time::Duration,
}

fn default_port() -> u16 { 8080 }

3. 枚举序列化

#[derive(Serialize, Deserialize)]
#[serde(tag = "type", content = "value")]
enum Message {
    Request { id: u32, data: String },
    Response { id: u32, result: i32 },
    Error(String),
}

// JSON表示：
// {"type":"Request","value":{"id":1,"data":"hello"}}

4. 多格式支持

// 二进制格式（更小更快）
let bincode_bytes = bincode::serialize(&user)?;
let decoded: User = bincode::deserialize(&bincode_bytes)?;

// TOML
let toml_str = toml::to_string(&config)?;

// YAML
let yaml_str = serde_yaml::to_string(&config)?;

📝 练习题

练习1：配置文件

用TOML格式实现应用配置的读写。

练习2：自定义序列化

实现DateTime的自定义JSON序列化格式。

练习3：版本兼容

实现支持多版本数据结构的反序列化。

🏆

成就解锁：数据转换师

掌握Serde——Rust序列化的瑞士军刀

⬅ 上一课 🏠 目录下一课 ➡

🔬 深度理解：异步编程模型

Rust的异步模型与其他语言有本质区别：

1. 编译器生成状态机

async函数不是语法糖生成闭包或Future对象，而是编译器生成一个状态机enum，每个.await点是一个状态。这比Green Thread更高效——无堆分配、无运行时开销。

2. 零成本异步

不使用的异步特性不产生代码。不调用async函数？没有状态机代码。这与其他语言的全局运行时（Go的goroutine调度器、Java的Fiber）不同。

3. 显式运行时

Rust没有内置异步运行时。你选择Tokio、async-std或其他——运行时是库，不是语言特性。这意味着灵活但需要选择。

📊 异步模型对比

模型	语言	开销	并发数
OS线程	C/Java	1-8MB/线程	~1000
Green Thread	Go	~2KB/goroutine	~100K
async/await	Rust	~几百字节	~1M+
回调	Node.js	小	高

🌐 网络编程最佳实践

背压控制：使用tokio::sync::Semaphore限制并发
超时设置：所有IO操作加超时，避免挂起
优雅关闭：监听信号，等待进行中的请求完成
连接池：复用TCP连接，减少握手开销
零拷贝：使用bytes::Bytes避免不必要的数据复制
结构化日志：使用tracing替代println

🧪 实战练习补充

以下练习帮助你将本课知识应用到实际场景：

练习A：代码审查

阅读以下代码片段，找出潜在问题并改进：

// 仔细阅读，思考有什么问题
fn process(data: Vec) -> Vec {
    let mut result = Vec::new();
    for i in 0..data.len() {
        result.push(data[i] * 2);
    }
    result
}

改进建议：使用迭代器、预分配容量、考虑溢出。

练习B：性能对比

用criterion基准测试对比以下实现的性能差异：

for循环 vs 迭代器
String拼接 vs write!宏
Vec::push vs Vec::with_capacity

练习C：API设计

为以下场景设计Rust API：一个支持过期时间的缓存系统。考虑所有权、错误处理和泛型。

📌 本课要点总结

通过本课的学习，你应该掌握以下核心要点：

理解Rust核心概念背后的设计哲学
能够将所学知识应用到实际编码中
知道何时选择哪种工具和模式
具备阅读和审查Rust代码的能力
能够独立解决编译器报告的问题

如果某个要点还不够清晰，回顾本课的代码示例和内存图，动手编写代码验证你的理解。

🔗 相关资源

The Rust Book — 官方教程
Rust by Example — 示例驱动学习
Rust Playground — 在线编写运行Rust
crates.io — Rust包仓库
docs.rs — 自动生成的文档
This Week in Rust — 社区周报
Rust用户论坛 — 问答社区

📚 扩展阅读

以下资源帮助你深入学习本课主题：

The Rust Programming Language — 官方教程，Rust圣经
Rust by Example — 通过示例学习Rust
Rust Reference — 语言参考手册
Rustnomicon — Unsafe Rust黑魔法指南
Too Many Lists — 用Rust实现各种链表

🔑 关键术语回顾

本课涉及的核心概念，确保你理解每一个：

术语	说明
所有权	Rust内存管理的核心机制，每个值有唯一所有者
借用	通过引用访问数据，不获取所有权
生命周期	引用有效的范围，编译期分析工具
trait	Rust的接口/抽象机制，类似其他语言的接口
泛型	参数化类型，零成本抽象
模式匹配	强大的数据解构和分支机制
零成本抽象	高层抽象不引入运行时开销
fearless concurrency	编译器保证线程安全

💬 学习建议

动手编码 — 每个代码示例都在本地运行一遍
修改实验 — 故意改错代码，看编译器报什么错
完成练习 — 每课的练习题是巩固知识的关键
阅读源码 — 看标准库和优秀开源项目的实现
写项目 — 真正掌握需要构建真实项目

🤔 常见问题

Q: Rust学习曲线真的很陡吗？

A: 前期确实需要适应所有权和借用检查器，但一旦理解了，这些概念会让你的代码更可靠。大多数人2-4周就能上手。

Q: Rust适合什么项目？

A: 系统编程、Web服务、CLI工具、嵌入式、WASM、网络服务、数据库等。基本上需要性能和安全的地方都适合。

Q: 遇到编译错误怎么办？

A: Rust编译器的错误信息非常友好！仔细阅读，通常会指出问题所在和修复建议。也可以用cargo clippy获取更多提示。