cargo-nextest 测试分片重试

CI 中 Rust 测试的痛点

在持续集成环境中，cargo test 的原生能力常面临三个典型问题：

• 全量运行效率低：大型工作区或 crate 的测试套件可能包含数千个测试用例，全量执行会导致 CI 流水线耗时过长，尤其在并行资源受限时更为明显。
• 故障隔离困难：当多个测试用例同时失败时，cargo test 的输出以串行日志为主，难以快速定位具体失败的测试及其上下文，尤其在分片并行场景下。
• 机器可读性不足：原生输出格式以人类阅读为主，解析失败原因、提取关键信息需要额外编写脚本，增加了 CI 集成的复杂度。

cargo-nextest 的核心能力

该技能通过 cargo-nextest 工具链解决上述问题，核心能力包括：

• 动态分片：根据测试用例的执行时间或历史数据自动划分分片，支持多机/多进程并行执行，显著缩短整体运行时间。例如通过 nextest run --shard-by time 实现时间感知的分片策略。
• 智能重试：对偶发失败的测试（如网络波动、资源竞争）自动重试，支持自定义重试次数和退避策略（--retries 3 --retry-backoff 5s），避免因临时问题导致的误判。
• 结构化输出：生成 JSON 格式的机器可读日志（--message-format json），包含每个测试的执行时间、状态、失败原因等元数据，便于 CI 系统解析和可视化。
• 故障摘要生成：自动聚合失败测试的详细信息，输出包含失败用例列表、错误堆栈、关联日志片段的摘要报告，加速故障排查流程。

适用边界与注意点

• 环境依赖：需要 Rust 工具链和 cargo-nextest 的安装（尽管 SKILL.md 未提供自动安装步骤，实际使用需手动安装）。
• 分片配置复杂度：动态分片依赖测试用例的历史执行数据，首次运行或测试结构变更后可能需要重新校准分片策略。
• 重试策略风险：过度依赖重试可能掩盖真实的测试不稳定性，需结合失败率阈值（如 --max-retries-per-test 1）避免无限重试。
• CI 集成要求：结构化输出需要 CI 系统支持 JSON 日志解析，部分传统 CI 平台可能需要额外的日志处理脚本。

该技能适用于需要高精度测试可靠性保障的 Rust 项目，尤其适合大型工作区、高并发测试场景或对 CI 反馈速度有严格要求的开发团队。