pytest-xdist的核心作用
Python测试过程中，默认的pytest执行方式是单进程串行运行所有测试用例，当项目用例数量达到数百甚至上千时，单核运行的耗时可能长达数十分钟。pytest-xdist插件可以将测试任务拆分成多个子进程并行执行，同时支持将任务分配到不同的CPU核心上，实现负载均衡，大幅提升测试执行效率。
该插件的核心优势在于不需要开发者手动拆分测试任务，它会自动根据配置的核心数量分配用例，同时支持多种负载均衡策略，适配不同的测试场景需求。
安装pytest-xdist
使用pip命令即可快速完成安装，执行以下命令：
pip install pytest-xdist
安装完成后可以通过pytest --version命令验证是否安装成功，若输出中包含xdist相关版本信息则说明安装正常。
基础用法：开启多核并行测试
只需要在执行pytest命令时添加-n参数即可指定使用的CPU核心数量，参数值可以是具体数字，也可以用auto让插件自动检测当前机器的可用核心数。
示例：使用自动检测的核心数运行测试：
pytest -n auto
如果当前机器有4个可用核心，该命令会自动启动4个进程并行执行测试用例，相比单核运行，耗时通常能降低60%到70%。
负载均衡策略配置
pytest-xdist提供了多种负载均衡策略，通过--dist参数可以指定不同的分配模式，适配不同的测试场景。
常用策略说明
- load：默认策略，将测试用例逐个分配到各个进程，直到所有用例分配完成，适合用例执行时间差异不大的场景。
- loadscope：同一个测试模块或者测试类中的用例会分配到同一个进程，避免类级别的fixture重复初始化，适合有类级别前置条件的测试场景。
- loadfile：同一个测试文件中的用例分配到同一个进程，适合文件内用例有共享资源的情况。
策略使用示例
使用loadscope策略运行测试：
pytest -n auto --dist=loadscope
代码示例：验证多核优化效果
先创建一个包含多个耗时测试用例的文件test_demo.py，用例中模拟每个测试执行1秒的耗时：
import time
def test_case1():
time.sleep(1)
assert True
def test_case2():
time.sleep(1)
assert True
def test_case3():
time.sleep(1)
assert True
def test_case4():
time.sleep(1)
assert True
首先使用单核方式运行，执行命令：
pytest test_demo.py -v
单核运行总耗时约为4秒，因为4个用例串行执行，每个1秒。
再使用4核并行运行，执行命令：
pytest test_demo.py -n 4 -v
此时总耗时约为1秒左右，4个用例同时在不同核心执行，效率提升明显。
注意事项
- 如果测试用例之间有依赖关系或者共享可变全局变量，并行执行可能会导致测试结果异常，这类用例需要单独标记后串行执行。
- 如果测试过程中需要操作同一个文件或者数据库资源，需要做好资源隔离，避免多个进程同时操作引发冲突。
- 进程数量不是越多越好，通常设置为机器可用核心数即可，过多的进程反而会增加进程切换开销，降低整体效率。
如果需要将部分用例标记为必须串行执行，可以使用pytest.mark.serial标记，然后在执行时排除这些用例或者单独运行。
pytest-xdist负载均衡多核利用率Python测试修改时间：2026-06-23 02:12:29