Rust / 系统课时
Option 与 Result 如何分工
Option 与 Result 如何分工
Option<T> 和 Result<T, E> 都能表达“这次没有拿到正常值”,但语义并不相同。前者描述“值可能不存在”,后者描述“操作可能失败”。选错类型,最常见的后果就是用 None 把真正的失败原因吞掉。
学习目标
- 区分“没有值”和“操作失败”两种语义
- 能根据调用方是否需要失败原因选择
Option或Result - 避免用
None隐藏解析、网络或权限等真实错误
Option 表达值可以不存在
Option<T> 只有 Some(T) 和 None。它适合“缺失本身就是正常情况”的场景,例如缓存未命中、集合查找不到元素、某个可选字段没有填写。
这里的 None 不表示程序出了错,而是在说:“这个位置当前没有值。”因此调用者通常只需要决定有值时怎么做、没值时怎么做,不需要追问失败原因。
Result 表达操作可能失败
Result<T, E> 的 Err(E) 会保存失败信息,适合解析失败、文件读取失败、权限不足、网络请求失败等场景。调用者不仅知道“没拿到值”,还知道“为什么没拿到”。
下面的程序同时展示两种语义:缓存查找不到用户是正常缺失,所以返回 Option;把文本解析成重试次数失败,需要保留原因,所以返回 Result。
rust
fn cached_user(id: u32) -> Option<&'static str> {
match id {
1 => Some("alice"),
_ => None,
}
}
fn parse_retry(raw: &str) -> Result<u32, String> {
raw.parse::<u32>()
.map_err(|_| format!("无法解析重试次数: {raw}"))
}
fn main() {
match cached_user(2) {
Some(name) => println!("cache: {name}"),
None => println!("cache: no value"),
}
match parse_retry("abc") {
Ok(retry) => println!("retry: {retry}"),
Err(err) => println!("retry error: {err}"),
}
}预期输出:
text
cache: no value
retry error: 无法解析重试次数: abc用语义而不是方便程度选择类型
| 问题 | 更适合的类型 | 原因 |
|---|---|---|
| 查找结果可能不存在,而且这很正常 | Option<T> |
调用者只关心有或没有 |
| 操作失败,需要知道原因 | Result<T, E> |
E 可以携带错误信息 |
| 缺失本身也算业务错误 | Result<T, E> |
应把“缺失”转换成明确错误 |
| 失败原因对调用方没有价值 | 可能使用 Option<T> |
仅在确认丢弃原因是设计意图时使用 |
一个实用判断是:如果调用者看到 None 后还会问“为什么没有”,那这个 API 往往更应该返回 Result。反过来,如果“没有”就是领域中的正常状态,就没必要人为制造错误类型。
不要用 None 吞掉真实故障
例如读取配置文件失败后直接返回 None,会让“文件不存在”“权限不足”“内容损坏”全部变成同一种结果,定位问题时几乎没有线索。此时应保留 Result,必要时再由更高层决定哪些错误可以降级为“无值”。
Option 和 Result 的核心分工不是“简单错误”和“复杂错误”,而是缺失是否正常,以及失败原因是否需要被保留。只要围绕这两个问题选择类型,API 的意图就会更清楚。
按自己的节奏,确认真正理解。