Rust / 系统课时

Result 如何表达两条执行路径

Result 如何表达两条执行路径

当一个函数既可能得到正常值,也可能因为输入或环境失败时,Rust 用 Result<T, E> 把两种结局放进同一个返回类型。这样,成功路径和失败路径都必须被显式处理,错误不会悄悄变成特殊值或被忽略。

学习目标

  • 理解 Ok(T) 与 Err(E) 分别承载什么信息
  • 能用 match 区分并处理成功与失败路径
  • 知道为什么 Result 能让失败进入类型检查范围

Result 把失败变成返回值的一部分

Result<T, E> 可以理解为“二选一”的枚举:操作成功时是 Ok(T),失败时是 Err(E)。调用者拿到的不是一个裸值,而是一个必须先判断分支的结果。

这与返回 -1、空字符串之类的约定不同。约定值需要调用者记住规则,而 Result 直接把失败可能性写进函数签名,编译器也会据此检查调用代码。

Result 的成功与失败分支

用 match 显式接住两条路径

下面的函数把字符串解析为端口。解析失败返回 Err,端口为 0 也视为业务校验失败;只有合法端口才进入 Ok。

rust
fn parse_port(raw: &str) -> Result<u16, String> {
    let port = raw
        .parse::<u16>()
        .map_err(|_| format!("非法端口: {raw}"))?;

    // 解析成功后仍可以继续做业务约束检查。
    if port == 0 {
        Err("端口不能为 0".to_string())
    } else {
        Ok(port)
    }
}

fn main() {
    for raw in ["8080", "abc", "0"] {
        match parse_port(raw) {
            Ok(port) => println!("{raw}: Ok({port})"),
            Err(err) => println!("{raw}: Err({err})"),
        }
    }
}

预期输出:

text
8080: Ok(8080)
abc: Err(非法端口: abc)
0: Err(端口不能为 0)

match 之所以重要,是因为它把两种结果都摆在代码表面。成功时可以继续使用 port,失败时拿到具体错误 err,两边的数据类型也分别由 T 和 E 决定。

Result 为什么适合传播错误

在上例中,? 遇到 Ok 会取出内部值继续执行,遇到 Err 则立即把错误返回给调用者。它没有消除失败路径,只是把“检查并提前返回”的样板代码缩短了。

因此,设计返回类型时先问一个问题:调用失败后,调用者是否需要知道失败原因并决定如何处理? 如果答案是肯定的,Result<T, E> 通常比特殊值或静默忽略更合适。它让错误既能被传播,也能在边界处被转换、记录或展示。

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

目录与阅读设置

阅读设置

17

记录一个想法

Result 如何表达两条执行路径

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

登录哪都通