Rust / 系统课时

用 nextest 加速测试反馈

用 nextest 加速测试反馈

当 Rust 项目的测试数量从几十个增长到几百、几千个时,cargo test 的反馈速度和故障定位都会开始影响开发节奏。本篇用 cargo-nextest 建立更细粒度的测试执行方式,并说明如何在本地与 CI 中逐步采用。

学习目标

  • 理解 nextest 与 cargo test 在测试调度上的核心区别。
  • 能使用 nextest 执行工作区测试,并根据并发、重试和分片需求调整配置。
  • 知道大型项目中哪些测试适合迁移,哪些场景仍应保留其他测试命令。

为什么大型项目会需要 nextest

cargo test 通常先构建测试二进制,再按测试二进制推进执行。一个二进制里只要还有一个慢测试,后续整体调度就可能受到拖累;同时,开发者更难直接得到每个测试的独立状态和耗时信息。

nextest 会先获取测试列表,再以测试为更细粒度的调度单位执行,并提供并发、重试、超时、测试分片等能力。这样大型工作区可以把长测试和大量普通测试更灵活地放到同一次运行中。

最小用法

在已经安装 cargo-nextest 的项目中,先直接运行整个工作区:

bash
cargo nextest run --workspace

预期结果

text
PASS  <test-name>
PASS  <another-test-name>

Summary: all selected tests passed

实际输出中的测试名称、数量、耗时和摘要会随项目内容变化。这里最重要的检查点是:测试被 nextest 单独列出执行,并在失败时能明确对应到具体测试。

与普通测试命令相比,迁移时先保持命令范围一致最安全。例如原来执行工作区测试,就先使用 --workspace,不要同时引入过滤、分片和特殊重试规则,以免改变反馈范围后难以比较速度变化。

用 profile 控制并发与失败行为

nextest 的仓库级配置可以放在工作区根目录的 .config/nextest.toml。本地开发通常关注反馈速度,而 CI 更关心完整收集失败信息,因此可以通过不同 profile 管理行为。

toml
[profile.default]
test-threads = "num-cpus"
retries = 0
flaky-result = "pass"

[profile.ci]
inherits = "default"
fail-fast = false
retries = 2

预期结果

text
默认执行使用 default profile。
CI 使用 ci profile 时,不会因为第一个失败测试立即停止,并允许失败测试按配置重试。

这里不要把“重试成功”误认为“测试稳定”。重试解决的是偶发失败对反馈流程的干扰,而不是替测试修复隐藏的竞态、共享状态或环境依赖。对于真正不稳定的测试,应继续追查根因。

大型工作区怎样进一步提速

当单机测试仍然过慢时,可以把测试拆到多个 CI worker。nextest 支持分区执行,例如把选中的测试切成三个 slice,再由三个任务并行运行:

bash
cargo nextest run --workspace --partition slice:1/3

预期结果

text
本次任务只执行第 1 个分片中的测试,其余分片由另外的 CI worker 执行。

分片之前要确保每个 worker 使用相同代码版本,并让构建结果尽量复用。对于大型 CI,还可以先生成测试归档,再在多个执行节点上运行,从而避免每个节点重复构建。

什么时候适合采用 nextest

如果项目测试数量多、测试二进制多、CI 时间明显被测试阶段占用,或者你希望获得更细粒度的失败反馈,nextest 通常值得纳入工程化工具链。迁移时建议先保持测试集合不变,再逐步调整并发、重试和分片。

还有一个实际边界:当前 nextest 不负责稳定 Rust 下的 doctest 执行,因此 doctest 仍应单独使用 cargo test --doc。这意味着工程里的“全部测试”命令可能最终仍由多个测试步骤组成,而不是强行只保留一个入口。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 nextest 加速测试反馈

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

登录哪都通