Rust / 系统课时
Result 如何表达两条执行路径
Result 如何表达两条执行路径
当一个函数既可能得到正常值,也可能因为输入或环境失败时,Rust 用 Result<T, E> 把两种结局放进同一个返回类型。这样,成功路径和失败路径都必须被显式处理,错误不会悄悄变成特殊值或被忽略。
学习目标
- 理解
Ok(T)与Err(E)分别承载什么信息 - 能用
match区分并处理成功与失败路径 - 知道为什么
Result能让失败进入类型检查范围
Result 把失败变成返回值的一部分
Result<T, E> 可以理解为“二选一”的枚举:操作成功时是 Ok(T),失败时是 Err(E)。调用者拿到的不是一个裸值,而是一个必须先判断分支的结果。
这与返回 -1、空字符串之类的约定不同。约定值需要调用者记住规则,而 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> 通常比特殊值或静默忽略更合适。它让错误既能被传播,也能在边界处被转换、记录或展示。
按自己的节奏,确认真正理解。