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 调整为:
[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 替换为下面的完整程序:
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 再唤醒并继续轮询这个任务。
运行并验证
在项目根目录执行:
cargo run -q预期输出:
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。