Rust RFC 3955:为 Fn 系 trait 边界引入具名函数参数(named_fn_trait_parameters)

原创2026-10-15 16:58:381,693 阅读
文章标签:文档

Rust RFC 3955:为 Fn 系 trait 边界引入具名函数参数(named_fn_trait_parameters)

在 Rust 中,impl Fn(String, usize) 这类函数 trait 边界只能以裸类型列表描述参数,读者无法知道每个位置的参数含义。RFC 3955(特性名 named_fn_trait_parameters)提出在 Fn、FnMut、FnOnce、AsyncFn、AsyncFnMut、AsyncFnOnce 的括号型泛型参数表中允许(可选的)具名参数,例如 impl Fn(msg: String, priority: usize)。读完本文,你将理解该 RFC 的三大动机、指南级用法、精确的文法(grammar)变更、与 fn 指针及 trait 函数的设计一致性权衡,以及尚待解决与未来可能演化的问题。

RFC 元信息与背景

该 RFC 提案文档位于 text/3955-named-fn-trait-parameters.md,关键元信息为:

  • Feature Name:named_fn_trait_parameters
  • Start Date:2026-04-24
  • 对应的跟踪 issue:rust-lang/rust#158499

背景问题是:函数 trait 边界目前只能写出参数类型的“位置列表”。以 log: impl Fn(String, usize) 为例,签名中没有任何线索说明 String 是“日志消息”、usize 是“优先级”,这一缺陷在签名越长、参数越多时越突出。RFC 的目标就是为这些位置赋予名字,且这些名字与 fn 指针的具名参数一样不改变 Rust 的语义——纯粹服务于可读性、文档与工具生态。

三大动机(Motivation)

RFC 在 text/3955-named-fn-trait-parameters.md 中给出了三个层次的收益,其中“更好的文档”是首要动机。

1. 更好的文档(Better documentation)

具名参数让签名自解释。对比:

// 参数含义不直观
fn parse_my_data(
    data: &str,
    log: impl Fn(String, usize)
) { }
// 加上名字后,参数语义一目了然
fn parse_my_data(
    data: &str,
    log: impl Fn(msg: String, priority: usize)
) { }

RFC 同时指出,这些参数名应当出现在 rustdoc 生成的文档中,使 API 使用者在文档站点上也能看到参数含义。

2. 更好的 LSP 提示(Better LSP hints)

在函数体内调用 log 时,LSP 可以基于参数名提供“inlay parameter name hints”(内嵌参数名提示),例如调用点 log("Message".to_string(), 1) 会被增强为带 data: / priority: 前缀的视觉提示。RFC 特别强调:这是该方案相对“用注释标注参数”写法的具体优势——注释只能停留在源码层面,无法被 LSP 这类工具消费:

// 注释方案:人类可读,但工具不可见
fn parse_my_data(
    data: &str,
    log: impl Fn(/* msg */ String, /* priority */ usize)
) { }

3. 与 fn 指针的一致性(Better consistency with fn pointers)

fn 指针早就支持具名参数。设想一个使用函数指针的版本:

fn parse_my_data(
    data: &str,
    log: fn(msg: String, priority: usize)
) { }

如果后续需求变化,用户希望改用 impl Fn,按现状就必须把参数名删掉,这在直觉上是反感的。本 RFC 消除了这个“换类型就要丢名字”的不便,使两种写法在签名层面可以平滑互换。

指南级说明(Guide-level explanation)

按照 RFC 指南级章节的口径(“假装该特性已在语言中”):

  • 可以为 Fn trait 及其“同族”的参数命名,以记录这些参数的含义,帮助调用方阅读你的函数;
  • 名字是可选的,且没有任何语义含义;
  • 具名参数与匿名参数可以混用:
fn parse_my_data(
    data: &str,
    log: impl Fn(String, priority: usize)
) { }

同一语法同样适用于** trait 边界(where-clause / 类型参数约束)**:

fn parse_my_data<
    L: Fn(msg: String, priority: usize)
>(
    data: &str,
    log: L
) { }

需要说明的是,语法上的适用面覆盖 Fn、FnMut、FnOnce 以及 AsyncFn、AsyncFnMut、AsyncFnOnce 六者。其中 AsyncFn* 一族的定义(以 Args 元组为泛型参数,如 pub trait AsyncFnOnce<Args>、pub trait AsyncFnMut<Args>: AsyncFnOnce<Args> 等)可见于 text/3668-async-closures.md:该族 trait 与 Fn* 一样,Args 被强制为元组,因此括号型参数列表语法在结构上是完全平行的。这也解释了为何 RFC 3955 在 Summary 中一次性列出六个 trait。

参考级说明:文法变更(Reference-level explanation)

这是本 RFC 的技术核心。RFC 指出,在本 RFC 之前,括号型泛型参数列表(parenthesized generic argument lists)的文法规则是:

GenericArgs ->
      `<` GenericArgList? `>`
    | `(` TypeList? `)` ( `->` TypeNoBounds )?

TypeList ->
    `(` Type `,` `)`* Type `,`?

RFC 将其替换为:

GenericArgs ->
      `<` GenericArgList? `>`
    | `(` MaybeNamedFunctionParameters? `)` ( `->` TypeNoBounds )?

MaybeNamedFunctionParameters →
    `(` MaybeNamedParam `,` `)`* MaybeNamedParam `,`?

MaybeNamedParam →
    OuterAttribute* (RestrictedPat `:`)? Type

从文法结构可以读出三层信息:

  1. <...> 角括号形态的泛型参数不受影响,变更只发生在 (...) 括号分支;
  2. 原来的 TypeList 生产规则被 MaybeNamedFunctionParameters 取代,其整体形状(前缀式自重复 + 末尾可选逗号)保持不变,因此纯匿名写法完全向后兼容;
  3. 每个参数项 MaybeNamedParam 的结构是:零个或多个外部属性(OuterAttribute*)、一个可选的 RestrictedPat : 前缀、然后才是 Type。? 号保证了 impl Fn(String, usize) 这类旧代码无需任何修改即可继续编译。

设计权衡一:允许属性(attributes)

参数上允许写外部属性,例如:

fn test(x: impl Fn(#[cfg(...)] msg: String, priority: usize), y: usize) { }

RFC 说明这一允许并非新发明的规则,而是与 fn 指针对齐——fn 指针上属性本来就已允许:

fn test(x: fn(#[cfg(...)] msg: String, priority: usize), y: usize) { }

设计权衡二:受限模式(RestrictedPat)只允许于语法层

具名位置的名称在语法上是一个 RestrictedPat,但在语义上被进一步限制为 IDENTIFIER | _。RestrictedPat 的文法为:

RestrictedPat ->
      `mut`? IDENTIFIER
    | ( `&` | `&&` )? ( `_` | `false` | `true` | IDENTIFIER )

RFC 特意举了两个对比来解释“为什么语法放宽、语义收紧”:

  • 与 fn 指针一致:由于语法层允许 RestrictedPat,以下程序可以编译(被 #[cfg(false)] 排除出实际构建,但语法/解析层面通过):
#[cfg(false)]
type F = fn(mut x: (), &x: (), &&x: (), false: (), &_: (), &true: ());
  • 与无函数体的 trait 函数对比:后者其实更宽松——语法上允许任意模式(arbitrary patterns),只是语义上仍会拒绝标识符以外的东西:
#[cfg(false)]
trait Test {
    fn x((x, y): usize);
}

也就是说,trait 函数签名连 (x, y): usize 这种元组模式都能通过解析。而 RFC 3955 选择了与 fn 指针对齐的 RestrictedPat 方案,而不是更宽松的任意模式方案。这一点也被列入缺点(Drawbacks):它使得 impl Fn 等函数的语法与 trait 定义中函数的语法保持不一致,其背后的理由即上述参考级解释。

缺点(Drawbacks)

RFC 如实列出两点:

  • 使 impl Fn 及其同族的语法略微复杂化;
  • 使 impl Fn 等与 trait 定义中函数的语法不一致(理由见上文 RestrictedPat 一节)。

设计依据与备选方案(Rationale and alternatives)

  • 必须由语言层面实现:该特性影响的是语言自身的语法糖(括号型泛型参数列表的解析),无法通过宏或库来提供;
  • 它让 Rust 代码更易读,因为它提供了更好地记录函数签名的方式。

既有实践(Prior art)

  • Rust 内部:fn 指针早已支持具名参数,这是本 RFC 最重要的参照系:
type LogFunction = fn(msg: String, priority: usize);
  • TypeScript:函数类型天然带具名参数:
type LogFunction = (msg: string, priority: number) => void;
  • Kotlin:函数类型参数可具名:
fun log(data: String, logFunction: (msg: String, priority: Int) -> Unit) { }

未决问题(Unresolved questions)

RFC 明确留了一个开放问题:是否允许重复的参数名。目前的现状是——fn 指针以及不带函数体的其他函数已经允许重名:

type T = fn(x: usize, x: usize);
trait Test {
    fn thing(x: usize, x: usize);
}

具名 fn trait 参数是否沿袭这一宽松行为,RFC 未作定论,交由后续讨论。

未来可能性(Future possibilities)

RFC 展望了两个方向,原则都是与 fn 指针的语法保持镜像:

  • 与“命名参数(named arguments)”特性的交互:例如,若未来命名参数采用 fn f(pub a: T, pub b: U) -> R 的写法,则函数 trait 对应为 Fn(pub a: T, pub b: U) -> R;
  • 与“默认参数(defaulted arguments)”特性的交互:若默认参数采用 fn(x: String, y: i32 = 0) 的写法,则函数 trait 对应为 Fn(x: String, y: i32 = 0)。

状态说明与延伸阅读

  • 本仓库为 Rust RFC 仓库,text/ 目录下存放各 RFC 提案文档;本 RFC 文档当前形态即提案文本(text/3955-named-fn-trait-parameters.md),其最终处置(合并 / 关闭 / 推迟)需以 Rust 项目 RFC 流程的讨论结果为准。
  • RFC 的整体流程(何时需要 RFC、生命周期、FCP 等)见 README.md;语言类 RFC 由 language 子团队管理并打 T-lang 标签,初始 triage 与 shepherding 规则见 lang_changes.md。
  • 若关心 AsyncFn* 族的来龙去脉(为何引入 async 版 Fn 族、async Fn 边界如何脱糖为 AsyncFn*),可阅读 text/3668-async-closures.md,其中给出了三个 AsyncFn* trait 的完整定义与 lending 语义。
  • RFC 文档的标准章节结构(Summary / Motivation / Guide-level / Reference-level / Drawbacks / Rationale / Prior art / Unresolved questions / Future possibilities)可对照 0000-template.md 理解,本文各小节亦按此骨架组织,便于读者回溯原文定位。

一句话总结:RFC 3955 以极小的文法改动(MaybeNamedParam → OuterAttribute* (RestrictedPat ':')? Type)换取签名可读性、rustdoc 文档质量与 LSP inlay 提示的三重收益,并刻意与既有 fn 指针语法对齐,是 Rust 语言层面一个典型的“低破坏、高可读性”改进提案。

登录后查看全文
rfcs