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。成功时继续使用解析后的数字,失败时保留完整错误字符串并输出拒绝原因。

rust
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}"),
    }
}

预期输出

text
configuration rejected: retries must be <= 5, got 9

这里的 Err(error) 没有把错误“变成布尔值”,而是直接取得原来的 String。因此失败分支仍然拥有具体原因,可以记录、转换或交给恢复逻辑。

注意值的所有权

match result 默认会消费 result;如果其中的 T 或 E 不是 Copy 类型,分支绑定通常会取得内部值的所有权。处理完成后再访问原来的 result,可能触发“值已被移动”的编译错误。

只想查看而不消费时,可以匹配引用:

rust
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());
}

预期输出

text
error=network unavailable
is_err=true

这种写法让分支拿到的是对内部值的借用,适合“检查后还要继续保留整个 Result”的场景。

match 与问号运算符怎么选

如果失败时只需要原样向上返回,? 更短,也更能突出主流程。只有当成功和失败需要不同的本地动作时,match 才真正有价值,例如失败后重试、降级、转换错误、打印不同提示,或成功后走另一条明确分支。

不要为了“显式”而把每个 Result 都展开成 match。判断标准不是语法偏好,而是当前这一层是否拥有足够信息,能够对 Ok 和 Err 做不同且有意义的处理。

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

目录与阅读设置

阅读设置

17

记录一个想法

match 精确拆分成功与失败

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

登录哪都通