pytest-xdist：把 pytest 测试分发到多核 CPU 执行

pytest-xdist：把 pytest 测试分发到多核 CPU 执行

写代码的人基本都用过 pytest，测试套件大了之后，执行时间会越来越长。pytest-xdist 就是解决这个问题的插件，它能把测试任务分发到多个 CPU 核心并行运行。目前在 GitHub 上有 1,865 个 Star。

核心用法只有一行

安装完后，运行测试时加上 -n auto 参数：

pytest -n auto

pytest 会自动检测当前机器有多少个 CPU 核心，然后启动同等数量的 worker 进程，把测试随机分配到这些进程里并行执行。对于 CPU 密集型的测试套件，这能大幅缩短总执行时间。如果机器有 8 核，理论上可以把测试时间压缩到原来的八分之一左右。

为什么测试并行化很重要

测试执行慢会带来很多问题。本地开发时，每次改完代码跑一遍完整测试，等待时间长会降低反馈效率，开发人员可能会因为懒得等而减少测试频率。CI 环境里，测试阶段占用的时间直接影响整个流水线的速度，测试跑得慢意味着部署周期变长。

传统的单进程执行模式有一个明显的瓶颈：无论机器有多少个核心，测试都是串行运行的。多核 CPU 的优势完全没有发挥出来。pytest-xdist 把这个问题解决了，它基于 execnet 库实现进程间通信，让多个 pytest 实例协同工作，每个 worker 独立运行一部分测试。

实际用起来怎么样

这个插件的定位很清晰，就是给 pytest 增加并行执行的能力。它不修改测试本身的逻辑，对现有测试代码的侵入性很低。大部分情况下，装上插件、加上参数就能直接用，不需要改任何测试代码。

不过也有需要注意的地方。测试并行执行时，如果多个测试用例共享了全局状态，或者同时操作了同一个外部资源（比如数据库、文件系统、网络端口），可能会出现竞争条件。这会导致在单进程下能通过的测试，并行运行时随机失败。

所以用这个插件的前提是，测试本身要满足无状态、可独立执行的要求。对于那些依赖固定执行顺序，或者有共享状态的旧测试，需要先做一些改造才能安全地并行化。

适用场景和建议

如果你的项目测试数量多、执行时间长，而且测试之间没有相互依赖，那这个插件很适合引入。特别是数据计算、API 接口测试、纯函数验证这类场景，并行化的收益比较明显，因为这类测试通常不依赖外部状态。

对于小型项目，测试本来就没几条，加上并行执行的开销反而可能得不偿失。建议先用 -n auto 跑一下，对比下单进程和并行模式的实际耗时，再决定是否长期启用。

pytest-xdist 的文档托管在 Read The Docs 上，配置项和进阶用法写得很清楚。除了 auto 模式自动检测 CPU 数量，也可以手动指定 worker 数量，或者配合更细粒度的负载均衡策略使用。对于大型项目的测试优化，这个插件是一个值得优先考虑的方案。

的负载均衡策略使用。对于大型项目的测试优化，这个插件是一个值得优先考虑的方案。