1 / 4概念
Functions
Rust 用 fn 项、闭包与函数指针三种形式表达“可调用的行为”,用 Fn/FnMut/FnOnce 描述它能被调用几次,用泛型与 trait bound 让调用点在编译期定死目标。判断标准不是“能不能把函数当参数传”,而是能否说清它捕获了什么、可以被调用几次、以及最终走的是内联还是间接调用。
1 概念
1.1 一句话定义
函数是具名的代码块,闭包是捕获了环境的匿名函数;两者都实现 Fn 系列 trait,因此都能作为参数、返回值与结构体字段被传递,其中 fn 项是零大小的具体类型,闭包是承载捕获值的匿名结构体类型。
1.2 它解决什么问题
- 行为需要像数据一样流动:比较器、重试策略、回调表、中间件链。
- 复用逻辑但要保留调用方上下文:闭包捕获局部变量,不必把状态摊平成参数。
- 抽象不应带来运行时成本:泛型实例化让 HOF 在热路径上等价于手写循环。
- 调用次数需要被类型系统区分:
FnOnce只能消费一次,FnMut允许修改捕获。 - 调用点需要可预测:静态分派可内联,动态分派只多一次间接跳转。
代价是闭包类型无法命名、捕获会牵扯所有权,以及泛型实例化会放大二进制体积。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 所有权、借用与生命周期规则 | Type |
trait 定义、impl 块与错误建模 | OOP |
unsafe、extern "C" 与 FFI 边界 | Feature: Interop |
Future、执行器与线程 | Async and Concurrency |
| 关键字、模式匹配与 edition 语法 | Syntax |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| fn item | 具名函数的零大小类型 | 不是函数指针 |
| function pointer | fn(A) -> B,8 字节的代码地址 | 不携带环境 |
| closure | 捕获环境的匿名函数值 | 类型无法写出 |
| capture | 闭包按需借用或夺取的外部变量 | 不是参数 |
Fn | 可多次调用,捕获以 & 访问 | 不是“普通函数” |
FnMut | 可多次调用,捕获以 &mut 访问 | 需要 mut 绑定 |
FnOnce | 至少可调用一次,可消费捕获 | 调用后闭包失效 |
move | 强制按值捕获 | 不是“移动闭包本身” |
| HOF | 接收或返回函数的函数 | 与宏无关 |
| UFCS | Type::method(receiver) 全限定调用 | 与方法调用等价 |
| associated function | 无 self 的关联函数 | 不是方法 |
const fn | 可在编译期求值的函数 | 不是 const 变量 |
| diverging function | 返回 !,永不正常返回 | 不是“返回空” |
2 机制
2.1 心智模型
把可调用的东西想成“一段代码加一份可选环境”。fn 项只有代码,大小为零;闭包是编译器生成的匿名结构体,字段就是被捕获的变量,调用时用 self 访问这些字段。泛型参数决定调用点看到的是具体类型还是 trait object,也就决定了这次调用最终是内联、单态化后的直接跳转,还是通过 vtable 的间接跳转。
2.2 机制拆解
- fn 项:每个函数有自己的零大小类型,可被强制转换为
fn指针;直接调用没有间接层。 - 泛型与约束:
fn f<F: Fn(i32) -> i32>(g: F)为每个实参类型生成一份代码,约束在编译期检查。 - 闭包类型与捕获:每个闭包字面量都有唯一匿名类型,捕获方式由闭包体逐变量推断:只读用
&,修改用&mut,移动或消费用值,move强制全部按值捕获。 - trait 层级:
Fn: FnMut: FnOnce是继承关系,要求Fn的地方可以传FnMut,反之不行;f(args)实际走call、call_mut或call_once。 - 返回闭包:捕获类型不可命名,因此只能写
impl Fn或Box<dyn Fn>;前者静态分派,后者可放进同一个集合。 - 方法解析:
x.m()依次尝试T、&T、&mut T的固有方法与 trait 方法;T::m(&x)是绕过自动借用与自动解引用的 UFCS 写法。 const fn与发散函数:const fn的函数体受限于编译期可执行的操作,既可求值也能运行时调用;返回!的函数可强制转换为任意类型,用来表达panic!、exit与不终止的循环。- 递归:函数调用自身时,栈帧按深度累积;Rust 没有保证尾调用优化,深度递归应改为迭代。
- 编译期动作:单态化负责生成实例,内联由优化器决定,
#[inline]只是提示;间接调用来自 trait object 与函数指针。
2.3 完整枚举
可调用实体与调用形式,这是 Rust 提供的完整集合:
| 形式 | 类型形态 | 可否捕获 | 分派方式 | 典型用途 |
|---|---|---|---|---|
| fn 项 | 零大小具名类型 | 否 | 静态 | 普通函数、回调默认值 |
函数指针 fn(A) -> B | 8 字节代码地址 | 否 | 间接 | C 风格表、运行时选择 |
| 非捕获闭包 | 零大小匿名类型 | 否 | 静态 | 可转换为 fn 指针 |
| 捕获闭包 | 含字段的匿名结构体 | 是 | 静态 | 迭代器适配、回调 |
泛型参数 F: Fn | 由调用方决定 | 是 | 静态、单态化 | 库 API、热路径 |
impl Fn 返回 | 不透明类型 | 是 | 静态 | 隐藏闭包类型 |
Box<dyn Fn> | 胖指针 | 是 | 动态 | 异构集合、运行时装配表 |
&dyn Fn | 借用胖指针 | 是 | 动态 | 临时回调、避免分配 |
| 固有方法 | fn(&self) 等 | 否 | 静态 | 类型自己的行为 |
| 关联函数 | 无 self | 否 | 静态 | 构造器 new |
const fn | 同 fn 项 | 否 | 编译期或静态 | 常量表、类型级常量 |
发散函数 -> ! | 返回 never 类型 | 否 | 静态 | panic!、exit |
| 递归函数 | 同 fn 项 | 否 | 静态 | 树遍历、分治 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| fn 项大小 | 0 字节 | 纯代码,无运行时表示 |
| 函数指针大小 | 1 个指针 | 64 位下 8 字节 |
| 非捕获闭包大小 | 0 字节 | 可强转为 fn 指针 |
| 捕获闭包大小 | 捕获字段之和 | 再加对齐填充 |
&dyn Fn 大小 | 2 个指针 | 数据 + vtable,16 字节 |
Box<dyn Fn> 大小 | 2 个指针 | 另加一次堆分配 |
| vtable 调用成本 | 1 次间接跳转 | 阻止跨调用内联 |
| 单态化副本 | 每个实例 1 份 | 闭包与泛型组合即实例 |
const fn 运行时成本 | 0 | 编译期已求值 |
| 递归栈帧 | 每层数百字节起 | 深度受线程栈限制,默认 8 MB |
3 实践
3.1 最小示例
一个程序同时展示 const fn、方法、UFCS、关联函数、闭包捕获、impl Fn、Box<dyn Fn>、函数指针、发散函数与递归:
struct Counter {
hits: u32,
}
impl Counter {
const fn new() -> Self { Self { hits: 0 } }
fn bump(&mut self) -> u32 { self.hits += 1; self.hits }
fn total(counter: &Counter) -> u32 { counter.hits }
}
const fn twice(x: u32) -> u32 { x * 2 }
const BASE: Counter = Counter::new();
const LIMIT: u32 = twice(3);
fn double(x: i32) -> i32 { x * 2 }
fn die(msg: &str) -> ! { panic!("{msg}") }
fn map_twice<F: Fn(i32) -> i32>(f: F, x: i32) -> i32 {
f(f(x))
}
fn adder(step: i32) -> impl Fn(i32) -> i32 {
move |x| x + step
}
fn scaler(factor: i32) -> Box<dyn Fn(i32) -> i32> {
Box::new(move |x| x * factor)
}
fn sum_to(n: u64) -> u64 {
if n == 0 { 0 } else { n + sum_to(n - 1) }
}
fn main() {
let mut counter = BASE;
assert_eq!(counter.bump(), 1);
assert_eq!(Counter::bump(&mut counter), 2);
assert_eq!(Counter::total(&counter), 2);
let add = adder(LIMIT as i32);
assert_eq!(map_twice(&add, 1), 13);
let triple = scaler(3);
assert_eq!(triple(2), 6);
let mut count = 0;
let mut tick = || { count += 1; count };
assert_eq!(tick(), 1);
assert_eq!(tick(), 2);
let label = String::from("hits");
let finish = move || format!("{label}={count}");
let f: fn(i32) -> i32 = double;
let g: fn(i32) -> i32 = |x| x + 1;
assert_eq!(f(2) + g(2), 7);
let n: u64 = if count > 0 { sum_to(10) } else { die("cold") };
println!("{} {n}", finish());
}
追踪一次执行:BASE 由 const fn new 在编译期算好,运行时只是一份普通值,因此可以 let mut 复制出来。counter.bump() 调用固有方法,Counter::bump(&mut counter) 是同一函数的 UFCS 写法,两者生成的代码相同。adder 返回的不透明类型实际是只含 step 一个字段的匿名结构体,map_twice 以泛型接收它,编译器为这个闭包类型单态化出一份 map_twice,因此 f(f(x)) 两次调用都可内联。scaler 返回 Box<dyn Fn>,triple(2) 经 vtable 间接跳转。tick 以 &mut count 捕获,编译器把它的调用点绑定到 FnMut;finish 前的 move 把 label 和 count 按值搬进闭包,此后 label 在外部失效。函数指针 g 由非捕获闭包强转而来。die 返回 !,所以 else 分支能直接充当 u64。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 定义函数 | fn f(x: i32) -> i32 { x } | 参数与返回都必须标注类型 |
| 泛型加约束 | fn f<F: Fn(i32) -> i32>(g: F) | 每个实参类型一份代码 |
| 闭包字面量 | |x| x + 1 | 类型由上下文推断 |
move 捕获 | move |x| x + base | 常配合 spawn 与返回闭包 |
| 返回闭包 | -> impl Fn(i32) -> i32 | 静态分派,类型不可命名 |
| 装箱闭包 | Box<dyn Fn(i32) -> i32> | 可放进 Vec,一次堆分配 |
| 借用 trait object | &dyn Fn(i32) -> i32 | 无分配,生命周期受限 |
| 函数指针 | fn(i32) -> i32 | 无环境,可跨 FFI |
| 方法调用 | counter.bump() | 自动借用与自动解引用 |
| UFCS | Counter::bump(&mut counter) | 消除方法名冲突 |
| 关联函数 | Counter::new() | 无 self,常作构造器 |
| 发散函数 | fn die() -> ! | 可转换为任意类型 |
| 编译期函数 | const LIMIT: u32 = twice(3); | 要求 const fn |
3.3 标准流程
- 先写具体 fn 项;只有当行为需要外部传入时才引入参数化。
- 参数位置优先用泛型
F: Fn(..) -> ..,需要存进结构体或集合时才改Box<dyn Fn>。 - 判断调用次数:只消费一次用
FnOnce,会修改状态用FnMut,纯读用Fn。 - 捕获无法逃逸出借用范围时,加
move并确认被搬走的值不再需要。 - 返回闭包只暴露
impl Fn,把捕获结构留在内部;需要异构集合时再装箱。 - 递归先确认深度上界,可能很深的递归改写为显式栈或迭代。
3.4 与相邻技术的组合
- 迭代器:
map、filter、fold都接收泛型闭包,整条适配器链通常被内联成一个循环。 - 线程:
thread::spawn要求move闭包与'static,捕获的数据必须拥有所有权。 - 异步:
async fn等价于返回impl Future的函数;async move块与move闭包捕获规则一致。 - trait 对象:
Box<dyn Fn>让回调表同构,代价是一次间接调用与一次分配。 - 错误处理与 FFI:
map_err、unwrap_or_else用闭包延迟构造错误或默认值;extern "C" fn与函数指针可穿过 ABI,闭包不行。
3.5 选型维度
| 维度 | fn 项 | 泛型 F: Fn | impl Fn 返回 | Box<dyn Fn> | fn 指针 |
|---|---|---|---|---|---|
| 能否捕获环境 | 否 | 是 | 是 | 是 | 否 |
| 分派方式 | 静态 | 静态 | 静态 | 动态 | 间接 |
| 可否内联 | 是 | 是 | 是 | 否 | 视情况 |
| 代码体积 | 一份 | 每实例一份 | 一份 | 一份 | 一份 |
| 存放异构集合 | 否 | 否 | 否 | 是 | 是 |
| 类型可命名 | 是 | 是 | 否 | 是 | 是 |
| 可跨 FFI | 是 | 否 | 否 | 否 | 是 |
| 调用次数约束 | 无 | 可写 FnOnce | 可写 FnOnce | 同左 | 无 |
3.6 决策规则
- 调用点在内循环里、且实例数量可控时,用泛型而非
Box<dyn Fn>。 - 需要把不同闭包放进同一个
Vec或字段时,只能装箱或统一为函数指针。 - 闭包要越过
spawn或函数返回边界时,先加move,再检查被捕获值的所有权。 - 报“cannot borrow as mutable”时,先把绑定改成
mut并确认约束是FnMut而不是Fn。 - 递归深度不可控时,不要依赖尾调用优化,改写成循环。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
泛型 F: Fn | 零成本、可内联 | 单态化膨胀、签名变长 | 库 API、热路径 |
Box<dyn Fn> | 异构、体积小 | 间接调用、堆分配 | 插件、回调表 |
| fn 指针 | 最简单、可跨 FFI | 无环境、调用不可内联 | C 接口、静态表 |
| 枚举分派 | 穷尽检查、无间接层 | 新增分支要改代码 | 有限状态机 |
| 手写循环 | 无抽象成本、易读 | 复用性差 | 一次性逻辑 |
| 宏生成 | 展开期定制 | 可读性与调试成本 | 样板代码 |
3.8 何时不该用
- 只有一处调用时不要为它抽 HOF,直接内联那几行更清楚。
- 不要把
Box<dyn Fn>当默认回调类型,除非确实需要异构集合。 - 不要在热路径上为了“省代码体积”改函数指针,间接调用往往更慢。
- 不要用
Rc<RefCell<_>>让Fn闭包绕过FnMut,应改约束;也不要为通过借用检查而move大结构体。 - 不要写深度未知的递归来替代简单循环。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| E0596 cannot borrow as mutable | 闭包要改捕获,但变量或闭包绑定不是 mut | 给变量加 mut,或把闭包绑定改 mut |
| E0507 cannot move out of captured variable | 在 FnMut 里试图消费捕获 | 用 Option::take 或改 FnOnce |
| E0373 closure may outlive current function | 闭包借用了将结束的局部值 | 加 move 或延长源数据 |
| E0597 borrowed value does not live long enough | 返回的闭包引用局部变量 | move 捕获所有权 |
| E0308 expected fn pointer, found closure | 捕获型闭包不能转 fn | 去掉捕获或改 impl Fn |
E0525 closure only implements FnMut, not Fn | 约束写得太严 | 放宽为 FnMut,或按 &mut 调用 |
| E0382 use of moved value | 闭包已按值捕获并消费 | 用引用捕获或重新构造 |
| 递归闭包无法声明 | 闭包类型引用自身 | 用 fn 项、结构体字段或间接 |
| 栈溢出(SIGSEGV / abort) | 递归过深或无终止条件 | 改迭代,或加大线程栈 |
| 热路径未见提速 | dyn 或指针调用阻止内联 | 改泛型并用 perf 复核 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
所有回调都用 Box<dyn Fn> | 无谓分配与间接调用 | 泛型参数 |
无脑 move 捕获整个结构体 | 所有权被吞、调用方无法复用 | 只捕获需要的字段 |
用 RefCell 让 Fn 能改状态 | 运行时 panic、约束被掩盖 | 改 FnMut |
| 为省体积把所有泛型换成函数指针 | 反而更慢、丢环境 | 保留泛型或测量后再换 |
| 用递归处理不可信深度输入 | 栈溢出、进程 abort | 显式栈或迭代 |
公开签名暴露 fn 参数做业务扩展点 | 调用方必须无状态 | impl Fn 或泛型 |
4.3 可观测信号
编译期:错误码 E0507、E0596、E0373、E0597、E0277、E0308 直接指出捕获或约束问题;cargo clippy 的 redundant_closure、needless_borrow 指出多余包装。体积与内联:cargo llvm-lines 看单态化膨胀,cargo bloat 定位大符号,cargo asm 确认目标函数是否还有 call 指令。运行期:perf 采样中的间接跳转、递归深度导致的栈峰值、Box<dyn Fn> 的分配次数。
4.4 安全 / 性能 / 一致性边界
- 安全:函数指针与闭包本身都是安全 Rust;只有在
unsafe上下文里调用不可信指针才涉及不变量,那属于 Interop 的边界。 - 性能:内联不是保证,
#[inline]只是给优化器的提示;泛型单态化换来的零成本以二进制体积与编译时间为代价。 - 一致性:闭包类型不可命名,因此不能出现在公开签名里;跨 crate 传递必须用
impl Fn、泛型或 trait object。 - 可维护性:
Fn约束比FnMut更严格,过严的约束会迫使调用方绕路;FnOnce最宽松,应优先在只消费一次的位置使用。