文章目录pytest-xdist把 pytest 测试分发到多核 CPU 执行核心用法只有一行为什么测试并行化很重要实际用起来怎么样适用场景和建议pytest-xdist把 pytest 测试分发到多核 CPU 执行写代码的人基本都用过 pytest测试套件大了之后执行时间会越来越长。pytest-xdist 就是解决这个问题的插件它能把测试任务分发到多个 CPU 核心并行运行。目前在 GitHub 上有 1,865 个 Star。核心用法只有一行安装完后运行测试时加上 -n auto 参数pytest -n autopytest 会自动检测当前机器有多少个 CPU 核心然后启动同等数量的 worker 进程把测试随机分配到这些进程里并行执行。对于 CPU 密集型的测试套件这能大幅缩短总执行时间。如果机器有 8 核理论上可以把测试时间压缩到原来的八分之一左右。为什么测试并行化很重要测试执行慢会带来很多问题。本地开发时每次改完代码跑一遍完整测试等待时间长会降低反馈效率开发人员可能会因为懒得等而减少测试频率。CI 环境里测试阶段占用的时间直接影响整个流水线的速度测试跑得慢意味着部署周期变长。传统的单进程执行模式有一个明显的瓶颈无论机器有多少个核心测试都是串行运行的。多核 CPU 的优势完全没有发挥出来。pytest-xdist 把这个问题解决了它基于 execnet 库实现进程间通信让多个 pytest 实例协同工作每个 worker 独立运行一部分测试。实际用起来怎么样这个插件的定位很清晰就是给 pytest 增加并行执行的能力。它不修改测试本身的逻辑对现有测试代码的侵入性很低。大部分情况下装上插件、加上参数就能直接用不需要改任何测试代码。不过也有需要注意的地方。测试并行执行时如果多个测试用例共享了全局状态或者同时操作了同一个外部资源比如数据库、文件系统、网络端口可能会出现竞争条件。这会导致在单进程下能通过的测试并行运行时随机失败。所以用这个插件的前提是测试本身要满足无状态、可独立执行的要求。对于那些依赖固定执行顺序或者有共享状态的旧测试需要先做一些改造才能安全地并行化。适用场景和建议如果你的项目测试数量多、执行时间长而且测试之间没有相互依赖那这个插件很适合引入。特别是数据计算、API 接口测试、纯函数验证这类场景并行化的收益比较明显因为这类测试通常不依赖外部状态。对于小型项目测试本来就没几条加上并行执行的开销反而可能得不偿失。建议先用 -n auto 跑一下对比下单进程和并行模式的实际耗时再决定是否长期启用。pytest-xdist 的文档托管在 Read The Docs 上配置项和进阶用法写得很清楚。除了 auto 模式自动检测 CPU 数量也可以手动指定 worker 数量或者配合更细粒度的负载均衡策略使用。对于大型项目的测试优化这个插件是一个值得优先考虑的方案。的负载均衡策略使用。对于大型项目的测试优化这个插件是一个值得优先考虑的方案。