Rust / 系统课时
理解 Future 与 Poll
理解 Future 与 Poll
Rust 的异步代码不会因为创建了 Future 就自动向前执行。真正的推进发生在执行器调用 poll 时;当条件尚未满足,Future 返回 Pending 并借助 Waker 请求之后再次调度。本节用一个两次轮询即可完成的自定义 Future 把这条链路跑通。
学习目标
- 理解 Future 的惰性:创建 Future 与执行其中逻辑是两件事。
- 能解释
Poll::Pending、Poll::Ready与Waker在执行器调度中的分工。 - 能写出一个最小自定义 Future,并通过输出观察两次
poll的状态变化。
Future 为什么是惰性的
调用 async fn 得到的是一个实现了 Future 的值,而不是已经执行完成的结果。Future 更像“尚待推进的计算状态”:只有执行器开始轮询它,函数体才会真正向前运行;单纯创建后放在变量里,不会主动启动后台工作。
await 也不是“阻塞直到结束”。它会让当前异步任务参与轮询目标 Future:如果目标返回 Ready(value),就继续向下执行;如果返回 Pending,当前任务暂停,把运行机会交回执行器。
Poll 与 Waker 如何形成循环
Future 的核心接口可以概括为:执行器拿到任务后调用 poll。如果当前状态足以产出结果,Future 返回 Poll::Ready(value);如果还要等待事件,就返回 Poll::Pending。但返回 Pending 之后,执行器不会无条件反复轮询,否则会造成忙等。
此时 Context 中的 Waker 提供了“以后再叫醒这个任务”的能力。I/O 驱动、定时器或 Future 自己保存必要的 Waker,在状态可能取得新进展时调用 wake,执行器再把任务放回可运行队列并重新 poll。

这条链路的关键不是“Pending 等一会儿就会自己变成 Ready”,而是Future 必须保证在可能继续推进时触发对应 Waker。如果没有唤醒动作,任务可能永远停在 Pending;如果无条件频繁唤醒,又会浪费 CPU。
写一个只需两次 Poll 的 Future
下面的 TwoPoll 第一次被轮询时返回 Pending,同时调用当前任务的 Waker;执行器收到唤醒后再次轮询,它才返回 Ready。这是教学用最小模型,真实 I/O Future 通常会在外部事件到达时唤醒任务,而不是立即自唤醒。
Cargo.toml:
[package]
name = "future-poll-demo"
version = "0.1.0"
edition = "2024"
[dependencies]
tokio = { version = "1", features = ["macros", "rt"] }src/main.rs:
use std::future::Future;
use std::pin::Pin;
use std::task::{Context, Poll};
struct TwoPoll {
polled_once: bool,
}
impl Future for TwoPoll {
type Output = &'static str;
fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
if self.polled_once {
println!("poll -> Ready");
Poll::Ready("done")
} else {
// 第一次没有结果,但明确请求执行器之后再调度当前任务。
self.polled_once = true;
println!("poll -> Pending");
cx.waker().wake_by_ref();
Poll::Pending
}
}
}
#[tokio::main(flavor = "current_thread")]
async fn main() {
let future = TwoPoll { polled_once: false };
println!("future created");
// 到 await 这里,Future 才交给执行器开始轮询。
let result = future.await;
println!("result = {result}");
}预期输出
future created
poll -> Pending
poll -> Ready
result = donefuture created 先出现,说明构造 Future 本身没有执行 poll。进入 .await 后第一次轮询得到 Pending;wake_by_ref 让当前任务重新进入可运行状态,第二次轮询才得到 Ready。执行器拿到 Ready 后会把这个 Future 视为完成,不再继续轮询。
Waker 的使用边界
真实 Future 返回 Pending 前,通常需要确保“负责完成这项工作的组件”持有最新的 Waker。例如套接字尚不可读时,由 I/O 驱动在可读事件到来后唤醒任务;定时器则在截止时间到达后唤醒任务。Waker 的职责只是通知“现在值得再 poll 一次”,并不直接携带 Future 的结果。
poll 本身应快速完成,不能为了等结果而长时间阻塞线程。自定义 Future 也不能把 Pending 当成普通循环条件持续自唤醒,否则会形成高 CPU 的忙轮询。正确模型是:能完成就 Ready,暂时不能完成就登记唤醒条件并 Pending,状态发生变化后再 wake。