Rust / 系统课时
使用 Result
使用 Result
Result 用类型明确表示“成功或失败”,适合文件读取、输入解析和网络请求等可恢复操作。本课将完成一个可运行示例,并掌握 match、? 和错误转换的基本用法。
学习目标
- 理解
Result<T, E>的成功值与错误值 - 使用
match分别处理Ok和Err - 使用
?向上传播错误并转换错误信息
Result 的基本结构
Result<T, E> 只有两个分支:Ok(T) 保存成功结果,Err(E) 保存失败原因。函数签名直接声明可能失败,调用者必须显式处理,不会像异常一样在代码中隐式跳转。
当错误能够被调用者处理时,返回 Result 比 panic 更合适。例如,字符串可能不是合法整数,但程序仍可以提示用户重新输入,而不必立即退出。
完整示例
下面的程序先把字符串解析为非零整数,再计算它的倒数。解析失败和数值为零都会返回错误,main 使用 match 输出不同结果。
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}"),
}
}
}预期输出:
4 -> 0.25
0 -> 错误: 数值不能为 0
abc -> 错误: 无法解析整数: invalid digit found in stringreciprocal("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可以在模块边界补充上下文或统一错误类型
下一课预告
下一课将进一步整理自定义错误类型与错误链,让多层调用在保留根因的同时提供清晰的业务上下文。