Rust / 系统课时
理解 Pin 与 Future 移动约束
理解 Pin 与 Future 移动约束
Pin 解决的是“某个值一旦开始依赖自身地址,就不能再被安全移动”的问题。异步 Future 可能在状态机内部形成对自身字段的引用,因此 Future::poll 接收的是 Pin<&mut Self>;理解这层约束后,就能判断 Tokio 日常代码何时完全不用碰 Pin,何时必须显式固定 Future。
学习目标
- 解释自引用 Future 在移动后为什么可能失效
- 区分
Pin与Unpin的基本语义 - 判断 Tokio 代码中需要显式
Pin的典型场景
Future 为什么不能随便移动
编译器会把跨 .await 仍然存活的局部变量放进生成的 Future 状态机。某些状态下,一个字段可能间接引用同一个 Future 中的另一个字段;如果 Future 在这之后整体换了内存地址,原引用记录的地址就可能失效。

这也是 Future trait 的核心方法把接收者写成 self: Pin<&mut Self> 的原因:执行器在轮询 Future 时,可以修改它的内部状态,但对可能是 !Unpin 的 Future,安全代码不能把整个值从已固定的位置搬走。
Pin 和 Unpin 各自保证什么
Pin<P> 是一个指针包装器。对 Pin<Box<T>> 来说,可以移动外层 Box 句柄,但被分配在堆上的 T 必须继续满足固定地址约束;对 Pin<&mut T> 来说,则是在借用期间禁止通过安全接口把被固定的 T 移出原位置。
Unpin 是自动 trait,表示“这个类型即使被 Pin,也不需要额外的不可移动保证”。当 T: Unpin 时,可以从 Pin<&mut T> 安全取得普通 &mut T;当 T: !Unpin 时,必须继续遵守固定地址约束。编译器生成的 async Future 不应被假定为 Unpin,所以通用 Future API 会按可能不可移动来设计。
移动句柄不等于移动 Future
下面的标准库示例把匿名 async Future 放进 Pin<Box<_>>。move_handle 接收并返回整个 Pin 句柄,句柄变量发生了移动,但堆中 Future 的地址保持不变。
use std::future::Future;
use std::pin::Pin;
fn move_handle<F: Future>(future: Pin<Box<F>>) -> Pin<Box<F>> {
// 移动的是 Pin<Box<F>> 句柄,不是堆上的 F。
future
}
fn main() {
let future = Box::pin(async { 42 });
let before = (&*future) as *const _ as *const ();
// 句柄经过按值传递后,比较被固定 Future 的地址。
let future = move_handle(future);
let after = (&*future) as *const _ as *const ();
println!("same address: {}", before == after);
}预期输出:
same address: true这个例子说明 Pin 并不是“变量名不能移动”,而是被 Pin 的目标值不能以破坏固定地址保证的方式移动。对 Pin<Box<F>>,移动指针句柄是安全的,因为它仍然指向同一块堆内存。
Tokio 里什么时候需要显式 Pin
大多数 Tokio 代码不需要手写 Pin。直接对 Future 使用 .await,或把 Future 交给 tokio::spawn,相关固定通常由编译器生成的状态机和执行器内部处理,调用者只需使用普通 async 语法。
显式 Pin 常出现在更底层或更灵活的场景:手动实现或调用 Future::poll、把不同 Future 统一存进 Pin<Box<dyn Future<...>>>、需要长期保存并反复以可变引用轮询同一个非 Unpin Future,或者自己实现异步组合器。Tokio 的 tokio::pin! 宏和 Box::pin 都可用于建立这种固定关系,前者通常固定到当前栈作用域,后者把值固定在堆上。
不要把 Pin 当成并发锁
Pin 只讨论内存位置与移动语义,不提供线程安全、互斥或生命周期延长。它不会自动让 Future 变成 Send、Sync 或 'static,也不会阻止多个任务并发访问共享数据。
判断是否需要显式 Pin 时,先问一个问题:你是否正在越过 .await 之外,直接保存、借用或手动轮询一个可能 !Unpin 的 Future?如果没有,通常让 .await 和 Tokio 运行时处理即可;如果有,就需要明确选择栈上固定还是 Pin<Box<_>>,并保持被固定值的地址稳定。