pytest-xdist 的核心功能是通过多进程分发测试任务，每个进程独立运行测试，确保测试隔离。2025 年 3 月 25 日，pytest-xdist 在 GitHub 上已有超过 1,200,000 次下载，表明其在测试社区中的广泛接受。

在自动化测试中，随着测试用例数量的增加，测试执行时间可能会显著延长，影响开发和交付效率。​为了解决这一问题，pytest-xdist插件应运而生，它通过并行化测试执行，显著缩短了测试运行时间。

pytest-xdist 是 pytest 的一个扩展插件，主要用于实现测试用例的并行执行和分布式测试。通过利用多进程或者多机分布式的方式，pytest-xdist 能够显著缩短测试执行时间，提升持续集成（CI）流程的效率。

pytest-xdist是基于pytest的一个插件，支持多进程并行或分布式执行测试用例。​利用多核CPU或多台主机的资源，pytest-xdist可以加快测试执行速度，提升CI/CD流程的效率。

在自动化测试中，当测试用例数量庞大时，单进程顺序执行的速度往往难以满足需求。pytest-xdist 是基于 pytest 的一个插件：

• 在单台机器上利用多进程并行运行测试，充分利用多核 CPU 的优势；

• 实现分布式测试，在多台机器上同时执行测试；

• 结合负载均衡策略（按用例、文件或模块分配任务），提高并行执行的效率；

• 支持自动失败重试、覆盖率统计等功能；

利用多进程并行或分布式执行测试用例，这不仅能显著缩短测试运行时间，还能提升 CI/CD 流程的效率。

安装与基本使用

从 pytest-xdist 文档：How to use 中，提取详细使用步骤：

步骤	描述	示例
安装 pytest-xdist	使用 pip 安装插件	pip install pytest-xdist
运行并行测试	使用 -n 选项指定工作进程数	pytest -n 4 使用 4 个进程并行运行测试
自动检测 CPU 核心	使用 -n auto 自动检测 CPU 核心数	pytest -n auto 自动分配进程数
配置测试分布	使用 --dist loadscope 指定分布范围，例如按类分配	pytest -n 4 --dist loadscope=class 按类分配测试
确保测试独立	测试需设计为无共享状态，使用 tmp_path 夹具为每个测试创建临时目录	在测试中使用 def test_example(tmp_path): 创建隔离文件操作
处理输出	使用 -s 选项捕获输出，避免多进程输出混乱	pytest -n 4 -s 捕获标准输出
分布式测试	使用 -a 选项指定远程机器，通过 SSH 连接多台机器	pytest -n 4 --dist ssh -a "machine1 machine2" 在多台机器上运行
监控进度	查看控制台输出，观察每个工作进程的测试进度	控制台显示类似 "worker1: test_module.py::test_func [PASSED]" 的信息

详细使用指南

以下是使用 pytest-xdist 进行高效并行自动化测试的系统性指南，确保测试工程师快速上手：

安装

通过 pip 安装 pytest-xdist 非常简单：

pip install pytest-xdist

安装后，可以通过 pytest -h 查看新增的命令行选项。

基本命令

最简单的并行运行命令是使用 -n 选项：

pytest -n 4

这里 4 表示使用 4 个进程并行运行测试

如果希望自动检测系统的 CPU 核心数，并充分利用所有资源，可以使用：

pytest -n auto

简单示例

下面是一个简单的示例，如何结合 pytest-xdist 进行并行测试

示例文件：test_sample.py

import time


def test_one():
    time.sleep(1)
    assert True

def test_two():
    time.sleep(1)
    assert True

def test_three():
    time.sleep(1)
    assert True

def test_four():
    time.sleep(1)
    assert True

运行以下命令来并行执行上述 4 个测试用例：

pytest -n 4 test_sample.py

此命令会将 4 个测试用例分配到 4 个进程中同时运行，从而显著减少总体执行时间。

负载均衡策略

pytest-xdist 支持多种负载均衡策略，通过 --dist 参数进行配置：

策略	说明
--dist=load	按测试用例均衡分配，默认策略。
--dist=loadscope	按测试模块分配，确保同一模块内的用例在同一进程执行，减少数据共享冲突。
--dist=loadfile	按文件级别分配测试，适用于每个文件测试之间相互独立的场景。

例如，按模块进行负载均衡：

pytest -n 4 --dist=loadscope

负载均衡策略可以根据项目的实际情况和测试用例的特点灵活选择：

• load 策略适合大多数测试用例都较为独立且执行时间均衡的情况，通过精细地按用例分配，能最大化利用多核 CPU 的优势。

• loadscope 策略在模块内测试共享资源或有较重初始化开销时更有优势，能够减少重复工作并控制状态影响范围

Selenium 并行 UI 自动化测试案例

在自动化测试中，Selenium 常用于 Web UI 测试，而 pytest-xdist 则能通过多进程并行运行测试用例，大幅缩短整体执行时间。

将二者结合使用时，需要注意以下几点：

• 独立 WebDriver 实例：由于测试在不同进程中并行执行，每个进程都必须创建自己的 WebDriver 实例，不能共享同一个浏览器驱动。

• 环境隔离：确保各个进程中的测试环境（如浏览器驱动、配置文件等）互不干扰，避免因资源竞争导致测试失败。

示例文件：test_multiple_search.py

import pytest
from selenium import webdriver
from selenium.webdriver.common.by import By


def create_driver():
    options = webdriver.ChromeOptions()
    options.add_argument('--headless')           # 使用无头模式
    options.add_argument('--disable-gpu')
    options.add_argument('--no-sandbox')
    options.add_argument('--window-size=1920,1080')
    return webdriver.Chrome(options=options)

@pytest.fixture(scope="function")
def driver():
    driver_instance = create_driver()
    yield driver_instance
    driver_instance.quit()

def test_google_search(driver):
    # 测试 百度 搜索
    driver.get("https://www.baidu.com")
    search_box = driver.find_element(By.ID, "kw")
    search_box.send_keys("pytest-xdist")
    search_box.submit()
    driver.implicitly_wait(3)
    assert "pytest-xdist" in driver.page_source

def test_bing_search(driver):
    # 测试 Bing 搜索
    driver.get("https://www.bing.com")
    search_box = driver.find_element(By.NAME, "q")
    search_box.send_keys("pytest-xdist")
    search_box.submit()
    driver.implicitly_wait(3)
    assert "pytest-xdist" in driver.page_source

def test_duckduckgo_search(driver):
    # 测试 DuckDuckGo 搜索
    driver.get("https://www.duckduckgo.com")
    search_box = driver.find_element(By.NAME, "q")
    search_box.send_keys("pytest-xdist")
    search_box.submit()
    driver.implicitly_wait(3)
    assert "pytest-xdist" in driver.page_source

使用 pytest-xdist 的 -n 参数启动并行执行，例如：

pytest -n 3 test_multiple_search.py

这将启动 3 个进程，每个进程各自运行不同的测试用例，从而加速整体测试执行。

Appium 移动端测试案例

在移动端自动化测试中，Appium 是一个常用工具，而 pytest-xdist 则可以将测试用例并行执行，从而大幅缩短总的测试时间。下面以 Android 计算器应用为例，展示如何利用 pytest-xdist 并行测试 App 的功能。

示例文件：test_calculator_app.py

本示例中包含两个测试用例：一个测试加法，一个测试减法。每个测试用例通过 pytest fixture 独立创建一个 Appium WebDriver 实例，确保并行运行时互不干扰。

import pytest
from appium import webdriver
from time import sleep


@pytest.fixture(scope="function")
def driver():
    # 配置 desired capabilities，根据实际情况调整 deviceName、appPackage 和 appActivity
    desired_caps = {
        "platformName": "Android",
        "deviceName": "Android Emulator",  # 或实际设备 ID
        "appPackage": "com.android.calculator2",
        "appActivity": ".Calculator",
        "automationName": "UiAutomator2"
    }
    # 启动 Appium WebDriver 实例
    driver_instance = webdriver.Remote("http://localhost:4723/wd/hub", desired_caps)
    yield driver_instance
    driver_instance.quit()

def test_addition(driver):
    """
    测试计算器的加法功能，计算 2 + 3 = 5
    注意：元素 ID 依据具体设备和计算器应用版本可能有所不同，请根据实际情况调整
    """
    # 点击数字 2
    driver.find_element_by_id("com.android.calculator2:id/digit_2").click()
    # 点击加号
    driver.find_element_by_id("com.android.calculator2:id/op_add").click()
    # 点击数字 3
    driver.find_element_by_id("com.android.calculator2:id/digit_3").click()
    # 点击等号
    driver.find_element_by_id("com.android.calculator2:id/eq").click()
    # 等待页面更新结果
    sleep(2)
    # 获取结果文本（此处 ID 根据具体 App 可能不同）
    result = driver.find_element_by_id("com.android.calculator2:id/formula").text
    assert result == "5", f"期望结果为 5，但实际结果为 {result}"

def test_subtraction(driver):
    """
    测试计算器的减法功能，计算 7 - 2 = 5
    """
    # 点击数字 7
    driver.find_element_by_id("com.android.calculator2:id/digit_7").click()
    # 点击减号
    driver.find_element_by_id("com.android.calculator2:id/op_sub").click()
    # 点击数字 2
    driver.find_element_by_id("com.android.calculator2:id/digit_2").click()
    # 点击等号
    driver.find_element_by_id("com.android.calculator2:id/eq").click()
    sleep(2)
    result = driver.find_element_by_id("com.android.calculator2:id/formula").text
    assert result == "5", f"期望结果为 5，但实际结果为 {result}"

​​​​​​​

使用 2 个进程并行执行测试：

pytest -n 2 test_calculator_app.py

此命令会启动 2 个 worker 进程，每个测试用例都在独立进程中运行，确保每个进程都有独立的 Appium WebDriver 会话。

在使用pytest-xdist进行并行测试时，需要注意以下几点：

1. 测试用例的独立性：​确保测试用例之间没有依赖关系，可以独立运行。​CSDN博客

2. 共享资源的管理：​如果测试用例共享资源（如文件、数据库等），需要确保并行执行时不会产生冲突。​

3. 环境隔离：​在多进程并行执行时，注意测试环境的隔离，避免相互影响。

使用时注意事项：

在使用pytest-xdist进行并行测试时，需要注意以下几点：

• 测试用例的独立性：​确保测试用例之间没有依赖关系，可以独立运行。

• 共享资源的管理：​如果测试用例共享资源（如文件、数据库等），需要确保并行执行时不会产生冲突。​

• 环境隔离：​在多进程并行执行时，注意测试环境的隔离，避免相互影响。

• 设备资源：并行测试会同时占用多个设备或模拟器，确保设备资源充足。如果使用同一设备，可能会引起会话冲突，建议配置多台设备或多个模拟器。

• desired capabilities：如果需要同时在多台设备上执行测试，请为每个设备配置不同的 deviceName、udid，并相应调整 Appium 服务端口。

最佳实践与建议

• 测试分类：将测试分为单元测试（适合并行）和集成测试（可能需顺序执行），优先并行单元测试。
• 资源管理：确保测试环境资源（如数据库连接）能支持并行执行，必要时限制工作进程数。
• 性能优化：对于 I/O 密集型测试，并行可能效果有限，建议结合异步测试。
• 日志记录：使用 Pytest 的日志插件（如 pytest-logging）记录详细输出，便于调试。

与其他工具的比较

以下是并行测试工具的对比：

工具	主要特点	适用场景
pytest-xdist	Pytest 插件，支持多进程和分布式测试	Python 项目，CI/CD 集成
nose2	Python 测试框架，支持并行测试	传统 Python 测试，社区较小
unittest	Python 内置框架，可结合 multiprocessing	基础测试，需自定义并行逻辑
TestNG	Java 测试框架，支持并行测试	Java 项目，需复杂配置
JUnit	Java 测试框架，可结合并行工具	Java 项目，需额外工具支持

研究表明，pytest-xdist 在 Python 社区中应用广泛，特别适合自动化测试。

使用 pytest-xdist 进行高效并行自动化测试，可显著缩短执行时间，但需确保测试独立性和正确配置。通过掌握安装、运行和优化技巧，您可以提升测试效率，确保软件质量。这不仅是技术工具，更是优化开发流程的关键。

“用 pytest-xdist 并行测试，让您的自动化从此飞速！”