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 的意图就会更清楚。

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

目录与阅读设置

阅读设置

17

记录一个想法

Option 与 Result 如何分工

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

登录哪都通