pytest-xdist 并行测试引擎

慢测试套件的真实代价

当 pytest 套件膨胀到几千条用例，串行执行的等待时间会直接吃掉开发反馈窗口。一次全量回归动辄十几分钟，工程师只能靠"跑一部分"来妥协，结果漏报在长时间后才暴露。问题通常不在于单条用例太慢，而在于执行模型没有并行：pytest 默认单进程跑完所有用例，再多的 CPU 核也用不上。

并行化如何工作

这个技能的核心是把测试执行扇出到多个 worker 进程：

• 分发模型：基于 pytest-xdist 的调度机制，将用例集合切分给各 worker，而不是让每个 worker 跑全量；
• 瓶颈定位：通过并行运行后的整体耗时与单 worker 耗时对比，快速找出拖慢套件的慢速反馈循环；
• 隔离策略：对明显的慢速模块单独拆分运行，避免它们拖累其他用例的反馈速度。

关键在于理解 xdist 的分发不是魔法：它默认按模块/文件粒度分配用例，适合用例间无共享状态的套件。

适用边界与注意点

• 用例独立性是前提：依赖执行顺序、共享临时目录或全局单例的用例，在并行下可能出现难以复现的竞态；
• 状态隔离成本：需要为每个 worker 准备独立的运行环境，数据库 fixture 要考虑分库或事务回滚；
• worker 数量需匹配硬件：盲目开多 worker 反而会因资源争抢变慢；
• 不适合即兴使用：套件本身结构混乱时，并行只是把混乱加速重放，先做用例分层再谈并行。