Tokio on 编程那些事儿

1 环境准备

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/setup

本教程将带你逐步完成构建 Redis 客户端和服务器的过程。我们将从 Rust 异步编程的基础开始，逐步深入。我们将实现 Redis 命令的一个子集，但会全面了解 Tokio。

你在本教程中要构建的项目在 GitHub 上以 Mini-Redis 的形式提供。Mini-Redis 的主要设计目标是学习 Tokio，因此注释非常详尽，但这也意味着 Mini-Redis 缺少你在真正的 Redis 库中会想要的一些功能。你可以在 crates.io 上找到可用于生产环境的 Redis 库。

2 Hello Tokio

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/hello-tokio

我们将从一个非常基础的 Tokio 应用开始。它会连接到 Mini-Redis 服务器，将键 hello 的值设置为 world，然后读回该键。这将使用 Mini-Redis 客户端库来完成。

创建新 crate

首先，创建一个新的 Rust 应用：

3 生成任务

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/spawning

我们要转换方向，开始编写 Redis 服务器。

首先，将上一节中的客户端 SET/GET 代码移到一个示例文件中。这样我们就可以针对自己的服务器运行它。

1
2


$ mkdir -p examples
$ mv src/main.rs examples/hello-redis.rs

然后创建一个新的、空的 src/main.rs 并继续。

4 共享状态

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/shared-state

到目前为止，我们有一个可以工作的键值服务器。然而，有一个重大缺陷：状态不会在连接之间共享。我们将在本文中修复这个问题。

在 Tokio 中有几种不同的共享状态的方式。

5 通道

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/channels

既然我们已经了解了 Tokio 中的并发，让我们在客户端应用这些知识。将我们之前编写的服务器代码放入一个显式的二进制文件中：

1
2


$ mkdir src/bin
$ mv src/main.rs src/bin/server.rs

然后创建一个新的二进制文件，其中包含客户端代码：

6 I/O

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/io

Tokio 中的 I/O 与 std 中的工作方式大致相同，但是异步的。有一个用于读取的 trait（AsyncRead）和一个用于写入的 trait（AsyncWrite。特定类型会视情况实现这些 trait（TcpStream、File、Stdout）。许多数据结构也实现了 AsyncRead 和 AsyncWrite，例如 Vec<u8> 和 &[u8]。这样就可以在需要 reader 或 writer 的地方使用字节数组。

7 分帧

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/framing

现在我们将把刚学到的 I/O 知识应用到 Mini-Redis 的分帧层实现上。分帧（framing）是将字节流转换为帧流的过程。帧是两个对等方之间传输的数据单元。Redis 协议帧定义如下：

8 深入 async

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/async

至此，我们已经相当全面地游览了异步 Rust 和 Tokio。现在我们将更深入地探讨 Rust 的异步运行时模型。在教程最开始，我们暗示异步 Rust 采取了一种独特的方式。现在，我们来解释这意味着什么。

9 Select

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/select

到目前为止，当我们想为系统增加并发时，会生成一个新任务。接下来我们将介绍一些在 Tokio 中并发执行异步代码的其他方式。

tokio::select! 宏允许同时等待多个异步计算，并在单个计算完成时返回。

10 流

Sun, 23 Aug 2026 16:54:00 +0800

原文链接: https://tokio.rs/tokio/tutorial/streams

流（stream）是一系列异步产生的值。它是 Rust std::iter::Iterator 的异步等价物，由 Stream trait 表示。流可以在 async 函数中迭代，也可以使用适配器进行转换。Tokio 在 StreamExt trait 上提供了许多常用适配器。