Rust / 系统课时

定义泛型

定义泛型

当多个函数或数据结构只有字段类型不同,复制代码会增加维护成本。本课通过一个可运行示例,统一演示函数、结构体、枚举和方法中的泛型参数,并说明何时需要添加 Trait 约束。

学习目标

  • 为函数、结构体、枚举和 impl 块声明泛型参数
  • 理解泛型参数在同一作用域中的类型一致性
  • 使用 Trait 约束开放只有部分类型支持的方法

泛型参数的基本规则

泛型参数写在名称后的尖括号中,例如 fn first<T>、struct Pair<T> 和 enum Outcome<T, E>。T、E 只是常用命名,真正含义由它们在参数、字段和返回值中的位置决定。

同一个泛型参数在一次具体调用中必须代表同一种类型。若结构体的两个字段都声明为 T,创建实例时两个字段就必须类型一致;需要不同类型时,应声明为 Pair<T, U>。

完整示例

下面的程序同时覆盖泛型函数、泛型结构体、泛型枚举和泛型方法,可直接保存为 src/main.rs 后运行。

rust
#[derive(Debug)]
struct Pair<T> {
    left: T,
    right: T,
}

impl<T> Pair<T> {
    fn new(left: T, right: T) -> Self {
        Self { left, right }
    }
}

impl<T: PartialOrd> Pair<T> {
    fn max(&self) -> &T {
        // 只有可比较的 T 才能使用这个方法
        if self.left >= self.right {
            &self.left
        } else {
            &self.right
        }
    }
}

#[derive(Debug)]
enum Outcome<T, E> {
    Success(T),
    Failure(E),
}

fn first<T>(items: &[T]) -> Option<&T> {
    items.first()
}

fn main() {
    let numbers = Pair::new(12, 30);
    let status: Outcome<&str, u16> = Outcome::Success("ready");
    let failed: Outcome<&str, u16> = Outcome::Failure(503);
    let names = ["Ada", "Linus"];

    println!("max = {}", numbers.max());
    println!("first = {:?}", first(&names));
    println!("status = {:?}", status);
    println!("failed = {:?}", failed);
}

预期输出

text
max = 30
first = Some("Ada")
status = Success("ready")
failed = Failure(503)

编译器会为实际使用到的具体类型生成对应代码,这称为单态化。因此,泛型通常不会引入运行时类型判断;类型错误会在编译阶段暴露。

方法与 Trait 约束

第一个 impl<T> 对所有 Pair<T> 都生效,因为构造方法只负责保存值。第二个 impl<T: PartialOrd> 只为可比较的类型提供 max,因为方法内部使用了 >=。

约束也可以写在 where 子句中。约束较短时直接写在尖括号后更紧凑;参数较多或约束较复杂时,where 更容易阅读。关键原则是只为实际使用的能力添加约束,不要提前要求 Clone、Display 等无关 Trait。

类型推断与显式标注

多数情况下,编译器能从实参推断泛型类型,例如 Pair::new(12, 30) 会得到 Pair<i32>。当枚举的某个类型参数没有出现在当前变体值中时,可能需要显式标注。

示例中的 Outcome<&str, u16> 明确了成功值和错误值的类型。若只写 Outcome::Success("ready"),错误类型 E 没有推断来源,编译器就会要求补充类型信息。

常见错误

不要把泛型理解成“任意类型都能执行任意操作”。在没有约束时,T 只能进行所有类型都支持的通用操作,例如移动、借用和存储。比较、格式化、复制或迭代等行为,都需要相应的 Trait 约束。

还要注意返回引用时的生命周期关系。示例中的 first 只有一个输入引用,编译器可以自动推断输出引用来自该切片;出现多个输入引用时,可能需要显式生命周期参数。

本课总结

  • 泛型参数让函数和数据结构复用与具体类型无关的逻辑
  • 同一泛型参数在一次实例化中必须对应同一种具体类型
  • 只有代码确实使用某种能力时,才为泛型添加对应 Trait 约束

下一课预告

下一课将继续学习 Trait 约束与 where 子句,重点处理多个泛型参数和组合约束的可读性。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义泛型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通