Rust / 系统课时
定义异步函数
定义异步函数
Rust 的 async fn 会把函数体编译成一个实现 Future 的状态机。调用它时只创建 Future,并不会立刻执行函数体;只有 Future 被异步运行时持续轮询,通常通过 .await 触发推进,代码才会从当前状态继续运行。
学习目标
- 使用
async fn定义带返回值的异步函数。 - 理解调用异步函数得到的是 Future,而不是立即得到结果。
- 通过
.await观察 Future 的惰性执行行为。
async fn 返回什么
普通函数在调用时立即执行并返回值;异步函数调用后先返回一个匿名 Future。可以把它理解为“尚未完成的计算描述”:其中保存了参数、局部状态以及下一次继续执行的位置。
下面这条关系很关键:调用异步函数 ≠ 执行完整函数体。真正推进 Future 的动作来自执行器对它的 poll;当 Future 暂时不能继续时返回 Pending,条件满足后再次被轮询,最终返回 Ready。

定义并等待异步函数
下面的最小项目使用 Tokio 提供执行器。fetch_label 本身只是普通的 async fn;在 main 中调用它后,先保存 Future,再通过 .await 取得最终返回值。
Cargo.toml 中加入依赖:
[package]
name = "async-fn-demo"
version = "0.1.0"
edition = "2021"
[dependencies]
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }这段配置为项目启用 Tokio 运行时和过程宏;执行 cargo run 能成功启动 #[tokio::main] 即可验证依赖生效。
async fn fetch_label(id: u32) -> String {
println!("进入异步函数体");
format!("item-{id}")
}
#[tokio::main]
async fn main() {
let future = fetch_label(7);
println!("Future 已创建");
// 到这里才等待并推进 future,函数体中的输出随后出现。
let label = future.await;
println!("结果: {label}");
}运行程序:
cargo run --quiet预期输出:
Future 已创建
进入异步函数体
结果: item-7输出顺序说明了惰性行为:fetch_label(7) 返回 Future 时,函数体里的第一条 println! 还没有执行。
.await 会暂停当前异步任务
.await 不是阻塞整个线程的“同步等待”。当被等待的 Future 返回 Pending 时,当前异步任务会让出执行权;运行时可以利用同一线程继续推进其他可运行任务。等条件满足后,执行器再次轮询当前 Future,并从先前保存的位置继续执行。
因此,异步代码仍然按源码顺序表达逻辑,但暂停点由 .await 明确标出。一个 async fn 可以包含多个 .await,编译器会为这些暂停点保存必要的局部状态。
使用时的边界
异步函数不能靠“调用但不等待”来保证执行。若创建的 Future 随后被丢弃,它通常不会自行完成;需要把它交给运行时等待,或者由运行时创建独立任务来驱动。
掌握 async fn 时应牢牢记住一件事:它定义的是可被推进的异步计算,而 .await 才把这个 Future 接入当前异步任务的执行流程。