Rust / 系统课时
定义泛型
定义泛型
当多个函数或数据结构只有字段类型不同,复制代码会增加维护成本。本课通过一个可运行示例,统一演示函数、结构体、枚举和方法中的泛型参数,并说明何时需要添加 Trait 约束。
学习目标
- 为函数、结构体、枚举和
impl块声明泛型参数 - 理解泛型参数在同一作用域中的类型一致性
- 使用 Trait 约束开放只有部分类型支持的方法
泛型参数的基本规则
泛型参数写在名称后的尖括号中,例如 fn first<T>、struct Pair<T> 和 enum Outcome<T, E>。T、E 只是常用命名,真正含义由它们在参数、字段和返回值中的位置决定。
同一个泛型参数在一次具体调用中必须代表同一种类型。若结构体的两个字段都声明为 T,创建实例时两个字段就必须类型一致;需要不同类型时,应声明为 Pair<T, U>。
完整示例
下面的程序同时覆盖泛型函数、泛型结构体、泛型枚举和泛型方法,可直接保存为 src/main.rs 后运行。
#[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);
}预期输出
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 子句,重点处理多个泛型参数和组合约束的可读性。