Rust / 系统课时
match 精确拆分成功与失败
match 精确拆分成功与失败
当成功与失败需要执行不同动作时,match 是处理 Result 最直接的工具。它不仅能区分 Ok 与 Err,还会把其中携带的值绑定到对应分支,让你可以继续使用成功结果、记录错误上下文或执行恢复逻辑,而不是把错误静默丢掉。
学习目标
- 用
match完整拆分Result<T, E>的Ok与Err分支 - 在两个分支中正确取得并使用成功值或错误值
- 判断什么时候应显式
match,什么时候用?更合适
match 如何拆开 Result
Result<T, E> 只有两个变体:Ok(T) 表示成功并携带结果值,Err(E) 表示失败并携带错误值。对它使用 match 时,编译器要求把可能出现的情况处理完整,因此不会漏掉失败路径。
最常见的结构就是 Ok(value) 与 Err(error)。变量名不是固定语法,而是模式绑定:匹配成功后,内部的值会进入对应变量,后续逻辑可以继续使用它。
在两个分支执行不同动作
下面的示例把重试次数限制在 0 到 5。成功时继续使用解析后的数字,失败时保留完整错误字符串并输出拒绝原因。
fn parse_retries(input: &str) -> Result<u8, String> {
// 先把字符串转换为数字,解析失败时补充配置语义。
let retries = input
.parse::<u8>()
.map_err(|err| format!("invalid retries: {err}"))?;
// 解析成功不代表业务约束已经通过。
if retries <= 5 {
Ok(retries)
} else {
Err(format!("retries must be <= 5, got {retries}"))
}
}
fn main() {
match parse_retries("9") {
Ok(retries) => println!("use retries={retries}"),
Err(error) => eprintln!("configuration rejected: {error}"),
}
}预期输出
configuration rejected: retries must be <= 5, got 9这里的 Err(error) 没有把错误“变成布尔值”,而是直接取得原来的 String。因此失败分支仍然拥有具体原因,可以记录、转换或交给恢复逻辑。
注意值的所有权
match result 默认会消费 result;如果其中的 T 或 E 不是 Copy 类型,分支绑定通常会取得内部值的所有权。处理完成后再访问原来的 result,可能触发“值已被移动”的编译错误。
只想查看而不消费时,可以匹配引用:
fn main() {
let result: Result<String, String> = Err("network unavailable".to_string());
// 对 &result 做模式匹配,只借用内部的 String。
match &result {
Ok(value) => println!("value={value}"),
Err(error) => println!("error={error}"),
}
// result 没被消费,之后仍然可以继续使用。
println!("is_err={}", result.is_err());
}预期输出
error=network unavailable
is_err=true这种写法让分支拿到的是对内部值的借用,适合“检查后还要继续保留整个 Result”的场景。
match 与问号运算符怎么选
如果失败时只需要原样向上返回,? 更短,也更能突出主流程。只有当成功和失败需要不同的本地动作时,match 才真正有价值,例如失败后重试、降级、转换错误、打印不同提示,或成功后走另一条明确分支。
不要为了“显式”而把每个 Result 都展开成 match。判断标准不是语法偏好,而是当前这一层是否拥有足够信息,能够对 Ok 和 Err 做不同且有意义的处理。