Rust / 系统课时

使用 match

使用 match

match 用模式逐一判断一个值,并返回命中分支的结果。它特别适合处理枚举,因为编译器会检查分支是否穷尽,从而避免遗漏状态,同时还能解构字段、匹配范围和绑定内部数据。

学习目标

  • 使用 match 穷尽处理枚举的所有变体
  • 匹配字面量、闭区间和复合结构
  • 理解分支顺序、通配模式与返回类型约束

match 的执行规则

match 先计算待匹配表达式,再按照从上到下的顺序测试各个分支。第一个匹配成功的分支会被执行,后续分支不再检查。

每个分支由“模式、=> 和表达式”组成。因为 match 本身也是表达式,所以所有可能返回值必须具有兼容类型,才能赋给变量或作为函数返回值。

穷尽处理与复合模式

下面的示例同时使用枚举变体、命名字段、字面量、范围和 @ 绑定。match 覆盖了 Command 的全部变体,因此可以通过编译。

rust
enum Command {
    Move { x: i32, y: i32 },
    SetLevel(u8),
    Quit,
}

fn describe(command: Command) -> String {
    match command {
        Command::Quit => String::from("quit"),
        // 复合模式:先匹配 Move,再要求 x 必须等于 0。
        Command::Move { x: 0, y } => format!("vertical move to y={y}"),
        Command::Move { x, y: 0 } => format!("horizontal move to x={x}"),
        Command::Move { x, y } => format!("move to ({x}, {y})"),
        // @ 在匹配范围的同时保留原始值。
        Command::SetLevel(level @ 1..=3) => format!("low level {level}"),
        Command::SetLevel(level @ 4..=7) => format!("medium level {level}"),
        Command::SetLevel(level) => format!("high level {level}"),
    }
}

fn main() {
    println!("{}", describe(Command::Move { x: 0, y: 8 }));
    println!("{}", describe(Command::SetLevel(5)));
    println!("{}", describe(Command::Quit));
}

预期输出:

text
vertical move to y=8
medium level 5
quit

Command::Move { x, y } 会把字段解构为同名变量。范围 1..=3 包含两端,level @ 1..=3 则既完成范围判断,又把实际值绑定到 level。

分支顺序与兜底模式

更具体的模式必须放在更宽泛的模式之前。若先写 Command::Move { x, y },后面的 x: 0 和 y: 0 分支将永远无法命中,编译器会提示不可达模式。

变量名模式会匹配任意值并完成绑定;下划线 _ 也匹配任意值,但不会保存它。使用 _ 可以忽略不关心的情况,不过在处理业务状态时不应过早使用兜底分支,否则新增枚举变体后可能无法得到编译器提醒。

返回值与所有权边界

按值匹配会取得被匹配值的所有权,分支中解构出的 String 等非 Copy 数据也会被移动。仍需继续使用原值时,可以匹配引用,例如对 &value 使用 match,或在模式中使用 ref 借用内部数据。

每个分支若包含多条语句,需要使用花括号,并让最后一个表达式作为返回值。不要在最后一个表达式后误加分号,否则该分支会返回单元类型 (),可能与其他分支的返回类型冲突。

本课总结

  • match 按顺序选择第一个命中的模式,并要求枚举分支穷尽
  • 模式可以同时完成变体判断、字段解构、字面量和范围匹配
  • 宽泛模式应放在后面,避免遮蔽具体分支或隐藏新增状态

下一课预告

下一课将继续学习更轻量的条件解构方式,并比较 if let 与完整 match 的适用场景。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 match

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

登录哪都通