Rust / 系统课时

运行与筛选测试

运行与筛选测试

测试数量增加后,全部执行会拖慢定位速度。本课通过一个可运行示例,掌握测试名称筛选、串行执行、成功输出显示和忽略测试运行,并分清 Cargo 参数与测试运行器参数的位置。

学习目标

  • 按测试名称或测试目标缩小执行范围
  • 控制测试线程数并查看打印输出
  • 正确运行 #[ignore] 标记的测试

准备可筛选的测试

下面的 src/lib.rs 包含两个普通测试和一个默认忽略的慢测试,可直接放入任意新建的 Rust 库项目:

rust
pub fn parse_number(input: &str) -> Result<i32, String> {
    input
        .trim()
        .parse::<i32>()
        .map_err(|_| format!("invalid number: {input}"))
}

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

    #[test]
    fn parse_valid_number() {
        println!("checking valid input");
        assert_eq!(parse_number(" 42 "), Ok(42));
    }

    #[test]
    fn parse_invalid_number() {
        println!("checking invalid input");
        assert_eq!(
            parse_number("abc"),
            Err("invalid number: abc".to_string())
        );
    }

    #[test]
    #[ignore = "simulates a slow external check"]
    fn slow_external_check() {
        println!("running slow check");
        assert_eq!(parse_number("7"), Ok(7));
    }
}

这段代码可以独立编译。#[ignore] 不会删除测试,只会让默认测试运行跳过它;需要时仍可通过命令显式执行。

理解参数分界线

cargo test 同时涉及 Cargo 和 Rust 测试运行器。双横线 -- 之前的参数交给 Cargo,之后的参数交给测试二进制。

写法 接收方 作用
cargo test parse_valid Cargo 转交名称过滤器 运行名称包含指定文本的测试
cargo test --test order_flow Cargo 只运行名为 order_flow 的集成测试目标
cargo test -- --test-threads=1 测试运行器 使用一个线程执行测试
cargo test -- --show-output 测试运行器 显示通过测试的标准输出
cargo test -- --ignored 测试运行器 只运行被忽略的测试

名称筛选是子字符串匹配,不要求输入完整函数名。过滤条件越具体,越适合快速复现单个失败;目标筛选则适合只运行某个集成测试文件。

按名称筛选测试

运行名称中包含 parse_valid 的测试:

bash
cargo test parse_valid

预期输出的关键部分:

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

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 2 filtered out

这里的 2 filtered out 包含另一个普通测试和被忽略的慢测试。若使用更宽的过滤词 parse_,两个普通解析测试都会匹配。

串行执行并显示输出

默认情况下,测试可能并行执行,而且通过测试的 println! 输出会被捕获。调试共享文件、固定端口或全局状态时,可以临时改为单线程并显示输出:

bash
cargo test -- --test-threads=1 --show-output

预期输出的关键部分:

text
running 3 tests
test tests::parse_invalid_number ... ok
test tests::parse_valid_number ... ok
test tests::slow_external_check ... ignored

successes:

---- tests::parse_invalid_number stdout ----
checking invalid input

---- tests::parse_valid_number stdout ----
checking valid input

test result: ok. 2 passed; 0 failed; 1 ignored; 0 measured; 0 filtered out

测试名称的显示顺序可能因工具链实现而不同,但单线程可以避免测试同时执行。--show-output 会在测试完成后展示已捕获内容,适合保留整洁的测试报告。

执行忽略测试

只运行带有 #[ignore] 的测试:

bash
cargo test -- --ignored

预期输出的关键部分:

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

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 2 filtered out

若要同时运行普通测试和忽略测试,可使用 cargo test -- --include-ignored。慢测试、外部服务测试或需要特殊环境的测试适合默认忽略,但应在持续集成的专门阶段定期执行,避免长期失效。

选择合适的筛选方式

定位单个失败时先用名称过滤;验证某个集成测试文件时使用 --test <目标名>;测试存在共享资源竞争时再临时设置 --test-threads=1。不要长期依赖串行执行掩盖测试之间的状态污染,根本修复仍应是隔离文件、端口和全局数据。

查看当前工具链支持的完整测试运行器参数,可执行:

bash
cargo test -- --help

预期结果:

text
Usage: <TEST_BINARY> [OPTIONS] [FILTERS...]

帮助文本会继续列出过滤、输出、线程和忽略测试等选项,具体排版可能随 Rust 版本变化。

本课总结

  • 测试名称写在 cargo test 后,测试运行器参数写在 -- 之后
  • --test-threads=1 控制执行并行度,--show-output 显示通过测试的打印内容
  • --ignored 只运行忽略测试,--include-ignored 同时运行全部测试

下一课预告

下一课将学习 Rust 文档注释与文档测试,让 API 说明中的代码示例也能随 cargo test 自动验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

运行与筛选测试

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

登录哪都通