如何为Rust中Fn约束的函数参数命名以添加文档说明？

在Rust里，你可以通过两种实用方式给Fn trait约束的输入参数命名并添加文档说明：

1. 使用类型别名（Type Alias） #

先定义带命名参数和文档注释的类型别名，再在函数定义中复用，既能保留参数含义，又让代码更清晰：

/// 接收三个维度参数的计算函数：
/// - `width`: 目标宽度值
/// - `height`: 目标高度值
/// - `depth`: 目标深度值
/// 返回f64类型的计算结果
type DimensionCalc = dyn Fn(width: usize, height: usize, depth: usize) -> f64;

fn foo<F: DimensionCalc>(f: F) {
    // 函数体逻辑
}

其他开发者查看foo函数时，能通过DimensionCalc的注释快速理解参数意义。

2. 自定义Trait（更灵活的方案） #

如果需要更细致的文档或额外逻辑约束，可定义自定义trait，在trait方法中明确参数命名和文档：

/// 用于维度计算的 trait
pub trait DimensionCalculator {
    /// 根据三个维度值计算结果
    /// # 参数
    /// * `width` - 物体的宽度
    /// * `height` - 物体的高度
    /// * `depth` - 物体的深度
    fn compute(&self, width: usize, height: usize, depth: usize) -> f64;
}

// 为所有符合签名的闭包/函数实现该trait
impl<F> DimensionCalculator for F
where
    F: Fn(usize, usize, usize) -> f64,
{
    fn compute(&self, width: usize, height: usize, depth: usize) -> f64 {
        self(width, height, depth)
    }
}

fn foo<F: DimensionCalculator>(f: F) {
    // 调用时可使用命名参数，提升可读性
    let result = f.compute(width: 10, height: 20, depth: 30);
    // 函数体逻辑
}

这种方式不仅能清晰标注参数含义，还支持调用时使用命名参数，让代码更易维护。

注意：直接在Fn trait约束里写Fn(width: usize, ...)虽然语法合法，但编译器不会保留这些名称的文档信息，所以上面两种方法是更有效的文档化途径。

内容的提问来源于stack exchange，提问作者benjamin-lieser