Rust / 系统课时

搭建 Tokio 项目

搭建 Tokio 项目

本节从一个空目录开始,搭建可直接运行的 Rust 2024 Edition + Tokio 1.x 项目。完成后,你会得到一个启用了最小运行时特性的二进制程序,并能用 async main 执行一次异步定时等待,确认 Tokio Runtime 已正确启动。

学习目标

  • 创建使用 Rust 2024 Edition 的 Cargo 二进制项目。
  • 按示例所需能力选择 Tokio 运行时特性,而不是直接依赖全部特性。
  • 运行 async main,并根据编译错误定位缺失的 feature。

创建 Rust 2024 项目

Rust 2024 Edition 从 Rust 1.85 起可用,因此先确保本机工具链不低于这一版本。执行 cargo new tokio-start --bin 创建项目,再进入 tokio-start 目录。即使新版 Cargo 已默认使用 2024 Edition,也建议在清单中显式确认,避免项目由旧模板生成。

将 Cargo.toml 调整为:

toml
[package]
name = "tokio-start"
version = "0.1.0"
edition = "2024"

[dependencies]
tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }

这里没有启用 full。macros 提供 #[tokio::main],rt-multi-thread 提供默认的多线程调度器,time 提供异步定时器。version = "1" 表示接受兼容的 Tokio 1.x 版本,实际解析出的精确版本会记录在 Cargo.lock 中。

编写 async main

把 src/main.rs 替换为下面的完整程序:

rust
use std::time::Duration;
use tokio::time::sleep;

#[tokio::main]
async fn main() {
    println!("runtime started");

    // sleep 会挂起当前异步任务,而不是让执行线程做同步睡眠。
    sleep(Duration::from_millis(100)).await;

    println!("async main finished");
}

#[tokio::main] 会生成启动 Runtime 并执行异步入口所需的包装代码。运行到 sleep(...).await 时,任务暂时让出执行权;定时器到期后,Runtime 再唤醒并继续轮询这个任务。

运行并验证

在项目根目录执行:

bash
cargo run -q

预期输出:

text
runtime started
async main finished

-q 会隐藏 Cargo 自身的大部分构建信息,因此这里可以直接观察程序输出。若首次构建需要下载依赖,网络耗时可能不同,但两行程序输出的顺序不变。

识别常见 feature 配置错误

Tokio 的模块很多能力都由 Cargo feature 控制。删除 macros 后,#[tokio::main] 无法使用;保留默认多线程 #[tokio::main] 却删除 rt-multi-thread,会在编译期提示缺少对应运行时能力;删除 time 后,tokio::time 模块不可用。

此时项目已经具备 Rust 2024 Edition、Tokio 多线程 Runtime、宏和时间驱动四个关键条件,后续添加异步网络、任务并发或同步原语时,只需继续为实际使用的 Tokio 模块补充对应 feature。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建 Tokio 项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通