Rust / 系统课时

定义异步函数

定义异步函数

Rust 的 async fn 会把函数体编译成一个实现 Future 的状态机。调用它时只创建 Future,并不会立刻执行函数体;只有 Future 被异步运行时持续轮询,通常通过 .await 触发推进,代码才会从当前状态继续运行。

学习目标

  • 使用 async fn 定义带返回值的异步函数。
  • 理解调用异步函数得到的是 Future,而不是立即得到结果。
  • 通过 .await 观察 Future 的惰性执行行为。

async fn 返回什么

普通函数在调用时立即执行并返回值;异步函数调用后先返回一个匿名 Future。可以把它理解为“尚未完成的计算描述”:其中保存了参数、局部状态以及下一次继续执行的位置。

下面这条关系很关键:调用异步函数 ≠ 执行完整函数体。真正推进 Future 的动作来自执行器对它的 poll;当 Future 暂时不能继续时返回 Pending,条件满足后再次被轮询,最终返回 Ready。

async 函数从创建 Future 到完成的执行关系

定义并等待异步函数

下面的最小项目使用 Tokio 提供执行器。fetch_label 本身只是普通的 async fn;在 main 中调用它后,先保存 Future,再通过 .await 取得最终返回值。

Cargo.toml 中加入依赖:

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] 即可验证依赖生效。

rust
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}");
}

运行程序:

bash
cargo run --quiet

预期输出:

text
Future 已创建
进入异步函数体
结果: item-7

输出顺序说明了惰性行为:fetch_label(7) 返回 Future 时,函数体里的第一条 println! 还没有执行。

.await 会暂停当前异步任务

.await 不是阻塞整个线程的“同步等待”。当被等待的 Future 返回 Pending 时,当前异步任务会让出执行权;运行时可以利用同一线程继续推进其他可运行任务。等条件满足后,执行器再次轮询当前 Future,并从先前保存的位置继续执行。

因此,异步代码仍然按源码顺序表达逻辑,但暂停点由 .await 明确标出。一个 async fn 可以包含多个 .await,编译器会为这些暂停点保存必要的局部状态。

使用时的边界

异步函数不能靠“调用但不等待”来保证执行。若创建的 Future 随后被丢弃,它通常不会自行完成;需要把它交给运行时等待,或者由运行时创建独立任务来驱动。

掌握 async fn 时应牢牢记住一件事:它定义的是可被推进的异步计算,而 .await 才把这个 Future 接入当前异步任务的执行流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

定义异步函数

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

登录哪都通