Rust / 系统课时

使用 Result

使用 Result

Result 用类型明确表示“成功或失败”,适合文件读取、输入解析和网络请求等可恢复操作。本课将完成一个可运行示例,并掌握 match、? 和错误转换的基本用法。

学习目标

  • 理解 Result<T, E> 的成功值与错误值
  • 使用 match 分别处理 Ok 和 Err
  • 使用 ? 向上传播错误并转换错误信息

Result 的基本结构

Result<T, E> 只有两个分支:Ok(T) 保存成功结果,Err(E) 保存失败原因。函数签名直接声明可能失败,调用者必须显式处理,不会像异常一样在代码中隐式跳转。

当错误能够被调用者处理时,返回 Result 比 panic 更合适。例如,字符串可能不是合法整数,但程序仍可以提示用户重新输入,而不必立即退出。

完整示例

下面的程序先把字符串解析为非零整数,再计算它的倒数。解析失败和数值为零都会返回错误,main 使用 match 输出不同结果。

rust
use std::num::ParseIntError;

fn parse_nonzero(input: &str) -> Result<i32, String> {
    // 将标准库解析错误转换为当前函数统一使用的字符串错误
    let value: i32 = input
        .trim()
        .parse()
        .map_err(|err: ParseIntError| format!("无法解析整数: {err}"))?;

    if value == 0 {
        return Err("数值不能为 0".to_string());
    }

    Ok(value)
}

fn reciprocal(input: &str) -> Result<f64, String> {
    // `?` 在失败时提前返回 Err,成功时取出 Ok 中的值
    let value = parse_nonzero(input)?;
    Ok(1.0 / value as f64)
}

fn main() {
    for input in ["4", "0", "abc"] {
        match reciprocal(input) {
            Ok(value) => println!("{input} -> {value}"),
            Err(err) => println!("{input} -> 错误: {err}"),
        }
    }
}

预期输出:

text
4 -> 0.25
0 -> 错误: 数值不能为 0
abc -> 错误: 无法解析整数: invalid digit found in string

reciprocal("4") 返回 Ok(0.25);另外两个输入分别触发业务校验错误和解析错误。程序没有崩溃,而是由调用者逐个决定如何展示失败信息。

match 与问号运算符

match 适合当前层必须立即处理两种结果的场景,例如输出提示、选择备用方案或统计失败次数。它能同时访问成功值和错误值,控制最明确。

? 适合当前函数无法解决错误、只需要交给调用者处理的场景。遇到 Ok 时取出内部值并继续执行;遇到 Err 时提前返回,因此使用 ? 的函数本身也必须返回兼容的 Result 或 Option。

转换错误类型

示例中的 parse() 返回 ParseIntError,但函数希望统一返回 String,因此使用 map_err 修改错误类型。小型命令行程序可以这样快速组织错误信息,公共库则更适合定义枚举错误,保留可匹配的错误类别和原始原因。

错误转换应发生在清晰的边界上:底层函数保留技术细节,上层函数补充业务上下文,最终由界面层或命令行入口决定展示给用户的文字。

避免无条件解包

unwrap() 会在 Err 时 panic,expect() 只是额外提供一条 panic 消息。它们不会让错误消失,只是把可恢复错误转换成程序终止。

测试代码、一次性脚本或已经验证不可能失败的位置可以使用解包。面向真实输入、外部服务和文件系统的生产代码,应优先使用 match、? 或组合方法处理错误。

本课总结

  • Result<T, E> 用 Ok 和 Err 显式表达可恢复操作的两种结果
  • match 负责就地分支处理,? 负责提前返回并向上传播错误
  • map_err 可以在模块边界补充上下文或统一错误类型

下一课预告

下一课将进一步整理自定义错误类型与错误链,让多层调用在保留根因的同时提供清晰的业务上下文。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Result

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

登录哪都通