常用 crate 生态

Rust 标准库很克制，很多能力要靠社区 crate 补。crates.io 上有上百万个包，但日常开发真正绕不开的就那么几个。这一章给你一份”起步必装清单”，每个讲清楚它是干嘛的、怎么用、当前版本大概多少。版本号我按 crates.io 在 2026-08-07 前后的状态核对，写代码时请以 cargo add 拉到的最新版为准。

1-1 serde：序列化与反序列化

serde 是 Rust 事实上的序列化框架，负责把 Rust 数据结构转成 JSON、TOML、YAML 等格式（序列化），以及反过来（反序列化）。它本身只定义机制，具体格式靠配套 crate，最常用的是 serde_json。

用法靠 #[derive(Serialize, Deserialize)]（这是过程宏，第 75 章讲过）：

use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize, Debug)]
struct User {
    name: String,
    age: u32,
}

fn main() {
    let u = User { name: "小明".into(), age: 18 };
    let json = serde_json::to_string(&u).unwrap(); // 序列化成 JSON 字符串
    println!("{}", json);

    let back: User = serde_json::from_str(&json).unwrap(); // 反序列化回来
    println!("{:?}", back);
}

Cargo.toml 里：serde = { version = "1", features = ["derive"] } 和 serde_json = "1"。核对时 serde 最新稳定版约 1.0.229，serde_json 约 1.0.151，都属于 1.0.x 长期系列，API 稳定。

1-2 reqwest：HTTP 客户端

要和网页、API 打交道，用 reqwest。它是基于 tokio 的异步 HTTP 客户端，也能同步用。常见场景：调用别人的 REST 接口、抓取网页。

use reqwest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let resp = reqwest::get("https://www.rust-lang.org")
        .await?
        .text()
        .await?;
    println!("获取到 {} 字节", resp.len());
    Ok(())
}

Cargo.toml：reqwest = { version = "0.13", features = ["json"] }（要 JSON 支持就开 json feature）。核对时 reqwest 最新稳定版约 0.13.4，处于 0.13.x 系列。注意它是异步的，示例用到了第 72 章的 #[tokio::main]。

1-3 clap：命令行参数解析

写命令行工具（CLI）时，解析 -h、--name value 这类参数是体力活，clap 替你包揽。配合 derive 写法，定义个结构体就自动获得参数解析和 --help：

use clap::Parser;

#[derive(Parser, Debug)]
#[command(name = "greet", about = "一个打招呼的小工具")]
struct Args {
    /// 要问候的名字
    #[arg(short, long)]
    name: String,
}

fn main() {
    let args = Args::parse();
    println!("你好, {}!", args.name);
}

运行 cargo run -- --name 小明 就会打印”你好, 小明!”，还自带 cargo run -- --help。Cargo.toml：clap = { version = "4", features = ["derive"] }。核对时 clap 最新稳定版约 4.6.x（4.x 系列）。

1-4 anyhow 与 thiserror：错误处理两件套

第 73 章我们提过这对组合。anyhow 提供”兜底”错误类型 anyhow::Error，适合应用层（尤其是 main）捕获任何错误：anyhow = "1"，核对时约 1.0.104。thiserror 用 #[derive(Error)] 帮库定义精准的错误枚举：thiserror = "2"，核对时约 2.0.18，当前是 2.x 系列。

// 库里：用 thiserror 定义精准错误
use thiserror::Error;

#[derive(Error, Debug)]
pub enum MyError {
    #[error("网络错误")]
    Network(#[from] reqwest::Error),
}

// 应用里：用 anyhow 兜底
// fn main() -> anyhow::Result<()> { ... }

经验搭配：写给别人用的库用 thiserror 定义清晰错误，自己写的应用用 anyhow 兜底，两者通过 #[from] 无缝衔接。

1-5 tokio 与 futures：异步底座

前面两章详细讲过 tokio（异步运行时，核对时约 1.53.1）。另一个常客是 futures：它提供 Future 的实用扩展、各种 Stream/Sink 工具、join!、select! 等组合子。很多异步代码里 use futures::prelude::*; 是标配。核对时 futures 约 0.3.33（0.3.x 系列，长期稳定）。

1-6 怎么管理这些依赖

加依赖最省事的方式是命令行：cargo add serde --features derive、cargo add tokio --features full。cargo add 会自动写进 Cargo.toml 并选合适的版本区间（caret，如 ^1.0），你通常不用手写死版本。

1-7 几个常用的补充 crate

除了前面几个”顶流”，还有几个也经常出现，认识一下不亏：log 是日志门面（只定义接口），真正落地要靠 env_logger 或 tracing；dotenvy 读取 .env 里的环境变量；chrono 处理日期时间；once_cell/once_lock 做懒初始化：LazyLock 自 Rust 1.80 起就在标准库 std::sync 中可用（用前需 use std::sync::LazyLock;），但它并不在 prelude 里；2024 Edition 的 prelude 只新增了 Future/IntoFuture。这些不是必装，但遇到对应需求时，它们是社区首选。

选 crate 有个原则：先看下载量、文档质量、最近是否还在维护，别盲目追新。下载量高、更新频繁的，通常生态更稳、坑更少。crates.io 上的”近 90 天下载”和”最近更新”两项是很好的健康指标。

1-8 依赖版本怎么写

Cargo.toml 里版本号用的是 caret 语义："1" 等价于 ^1，表示允许 1.x 的最新兼容版；"0.13" 表示允许 0.13.x。为什么 0.x 要锁住 minor？因为 Rust 生态约定：0.x 的 minor 版本升级（如 0.11 到 0.12）可能含破坏性改动，所以要保守；而 1.0 之后，只有 major（1 到 2）才可能不兼容，minor（1.0 到 1.1）保证向后兼容。理解这个，你就不会奇怪为什么 reqwest 是 0.13 而 serde 是 1.0。

1-9 这些 crate 如何协作

一张典型的应用图谱：用 clap 解析命令行参数，用 reqwest 异步拉取远程数据，用 serde/serde_json 把响应解析成结构体，业务逻辑里用 thiserror 定义错误、anyhow 在 main 兜底，全程跑在 tokio 运行时上。它们不是孤立的，而是像积木一样拼出应用的骨架。

当你把这套组合用熟，会发现 Rust 写真实项目并不”缺胳膊少腿”——标准库给地基，这几个 crate 给梁柱，剩下的就是你的业务逻辑。这也是为什么 Rust 生态虽不及某些老语言庞大，却足够撑起生产级系统。

1-10 依赖冲突与 Cargo.lock

多人协作或 CI 时，Cargo.lock 是关键文件：它锁死了每个依赖的确切版本，保证所有人、每次构建都一致。约定是：应用 crate 应该提交 Cargo.lock（确保可复现构建），而库 crate 通常不提交（让使用者自己解析版本）。如果你 cargo build 报依赖冲突——比如两个 crate 要求同一个底层库的不同不兼容版本——可以用 cargo tree 查依赖树，定位是谁引入了冲突版本，再考虑升级或 cargo update 协调。

1-11 小结

Rust 生态的”标配”就这几个：serde 管序列化、reqwest 管 HTTP、clap 管命令行、anyhow/thiserror 管错误，再配 tokio/futures 这套异步底座，绝大多数应用骨架就搭起来了。记住用 cargo add 加依赖、版本写大版本号，别手写死。学完这些 crate，你其实已经具备写一个真实小工具的能力：读配置、发请求、解析数据、处理错误，一条龙都在生态里。剩下的只是多读文档、多动手，把这套组合练熟。下一章我们触碰 Rust 的”危险区域”——unsafe 与原始指针。