Rust / 系统课时

用过滤器缩小测试执行范围

用过滤器缩小测试执行范围

当测试数量增长后,cargo test 一次跑完整套测试会拖慢反馈,也不利于定位单个失败。本文用名称过滤、忽略测试和串行执行,把执行范围缩到当前真正关心的部分。

学习目标

  • 掌握按测试名称过滤的写法
  • 理解 #[ignore] 与 --ignored 的配合方式
  • 会用 --test-threads=1 在需要时串行执行测试

按名称过滤测试

cargo test <过滤字符串> 会把过滤字符串传给测试程序,名称包含该字符串的测试才会执行。它适合先验证某个模块、某组行为,或刚修改的一小批测试。

例如下面的测试包含三个不同用途的名称:

rust
#[cfg(test)]
mod tests {
    #[test]
    fn user_create_success() {
        assert_eq!(2 + 2, 4);
    }

    #[test]
    fn user_create_duplicate() {
        assert_eq!(3 + 3, 6);
    }

    #[test]
    fn order_cancel_success() {
        assert!(true);
    }
}

预期结果

text
上面的代码应编译通过,并注册 3 个测试:user_create_success、user_create_duplicate、order_cancel_success。

在项目根目录执行过滤:

bash
cargo test user_create

预期输出

text
running 2 tests
test tests::user_create_duplicate ... ok
test tests::user_create_success ... ok

 test result: ok. 2 passed; 0 failed; 0 ignored

过滤器是名称匹配工具,不是精确的唯一 ID。名称设计得越有规律,后续按功能筛选就越方便。

让忽略测试只在需要时执行

给测试加上 #[ignore] 后,普通测试运行不会执行它。适合耗时较长、依赖外部服务、需要特殊环境或暂时不适合进入默认反馈链路的测试。

rust
#[cfg(test)]
mod tests {
    #[test]
    fn fast_unit_test() {
        assert_eq!(10 - 3, 7);
    }

    #[test]
    #[ignore]
    fn slow_integration_like_test() {
        assert_eq!(20 / 4, 5);
    }
}

预期结果

text
普通 cargo test 时:1 个测试通过,1 个测试被忽略。

需要专门检查忽略测试时执行:

bash
cargo test -- --ignored

预期输出

text
running 1 test
test tests::slow_integration_like_test ... ok

 test result: ok. 1 passed; 0 failed; 0 ignored

这样可以把“默认快速反馈”和“专门运行慢测试”拆开,而不是每次都付出全部执行成本。

必要时改成串行执行

Rust 测试默认会并发执行。若测试共享文件、环境变量、临时资源或其他全局状态,并发运行可能让问题复现变得困难。此时可以把测试线程数设为 1。

bash
cargo test -- --test-threads=1

预期输出

text
running <N> tests
test <测试名> ... ok
...

 test result: ok. <N> passed; 0 failed; <M> ignored

其中 <N> 和 <M> 取决于当前项目的测试数量。串行执行不会改变测试筛选规则,只改变测试之间的执行并发度,因此可以和名称过滤组合使用:

bash
cargo test user_create -- --test-threads=1

预期结果

text
只有名称匹配 user_create 的测试会执行,并且这些测试按单线程顺序运行。

排查并发相关问题时,先缩小名称范围,再切换为串行,通常比一开始就全量单线程运行更容易定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

用过滤器缩小测试执行范围

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

登录哪都通