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 的测试会执行,并且这些测试按单线程顺序运行。排查并发相关问题时,先缩小名称范围,再切换为串行,通常比一开始就全量单线程运行更容易定位。
按自己的节奏,确认真正理解。