Rust / 系统课时

测试 Result 与 Option 的分支

测试 Result 与 Option 的分支

Rust 的 Result 和 Option 都要求调用者明确处理分支,因此单元测试不能只验证“成功时有值”。更可靠的测试会把 Ok、Err、Some、None 分别作为可观察行为,避免错误路径长期无人验证。

学习目标

  • 为 Result 的成功与失败分支分别设计断言
  • 为 Option 的存在与缺失分支分别设计断言
  • 选择 assert_eq!、is_ok、is_err 等与意图匹配的断言方式

Result 应同时验证成功和失败

先看一个最小的纯函数:合法输入返回 Ok,非法输入返回 Err。测试时不仅要确认成功值正确,还要确认错误分支确实发生,并检查错误信息是否符合调用方约定。

rust
fn parse_port(input: &str) -> Result<u16, &'static str> {
    let port = input.parse::<u16>().map_err(|_| "invalid port")?;
    if port == 0 {
        return Err("port must be greater than zero");
    }
    Ok(port)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn returns_ok_for_valid_port() {
        assert_eq!(parse_port("8080"), Ok(8080));
    }

    #[test]
    fn returns_err_for_non_numeric_input() {
        assert_eq!(parse_port("abc"), Err("invalid port"));
    }

    #[test]
    fn returns_err_for_zero_port() {
        assert_eq!(parse_port("0"), Err("port must be greater than zero"));
    }
}

预期结果

text
测试通过:3 个测试全部通过。

直接比较整个 Result 是一种清晰的选择,因为它同时验证了变体和值。对于只关心分支而不关心具体错误内容的场景,也可以使用 is_err();关键是让断言表达测试意图。

Option 不要只测 Some

Option 常用于“可能找到,也可能找不到”的查询。测试时最容易遗漏的是 None,因为正常开发流程往往只关注找到数据的路径。

rust
fn find_role(user_id: u64) -> Option<&'static str> {
    match user_id {
        1 => Some("admin"),
        2 => Some("editor"),
        _ => None,
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn returns_some_for_known_user() {
        assert_eq!(find_role(1), Some("admin"));
    }

    #[test]
    fn returns_none_for_unknown_user() {
        assert_eq!(find_role(99), None);
    }
}

预期结果

text
测试通过:2 个测试全部通过。

Some 测试确认找到目标时返回了正确值,None 测试确认未知输入不会被错误地映射到某个默认角色。这样的组合能覆盖调用方最常见的两个分支。

选择与意图匹配的断言

当你关心具体值时,优先使用 assert_eq!;只关心是否失败时可以使用 is_err();只关心是否存在时可以使用 is_some() 或 is_none()。不要为了形式统一而使用一种断言覆盖所有场景。

对于 Result,还要区分“错误发生”与“错误内容正确”两个层次。解析器、权限校验等业务通常依赖具体错误类型或消息,此时应断言错误值;对于只需要验证拒绝行为的测试,验证 Err 变体即可。

最后检查分支是否完整:每个 Result 至少思考一次 Ok 与 Err,每个 Option 至少思考一次 Some 与 None。这样写出来的测试不仅能证明成功路径,也能防止错误处理在后续重构中被意外删除。

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

目录与阅读设置

阅读设置

17

记录一个想法

测试 Result 与 Option 的分支

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

登录哪都通