能否为TOX作业启用快速失败（Fast Fail）功能？

TOX本身没有专门的配置项开启全局快速失败，但可以通过以下两种方式实现需求：

方法1：使用TOX并行运行模式的--onfail参数 #

如果你使用的是TOX 3.10及以上版本，可借助并行运行功能实现快速失败：

• 运行TOX时添加参数：tox --parallel auto --onfail stop
  • --parallel auto：让TOX自动根据CPU核心数并行运行测试环境
  • --onfail stop：一旦任意一个测试环境失败，立即停止所有后续测试任务

如果需要固定并行数量，比如仅并行2个环境，可将auto替换为数字，如--parallel 2。

方法2：自定义脚本逐个运行环境（适用于所有TOX版本） #

若不想用并行模式，或使用旧版TOX，可编写简单脚本逐个执行测试环境，遇到失败立即退出：

Bash脚本示例 #

#!/bin/bash
# 定义要运行的TOX环境列表
ENVS=("py38" "py39" "py310" "flake8")

for env in "${ENVS[@]}"; do
    echo "Running tests for environment: $env"
    tox -e "$env"
    # 检查上一条命令的退出码，非0则表示失败，立即退出脚本
    if [ $? -ne 0 ]; then
        echo "Environment $env failed, aborting remaining tests"
        exit 1
    fi
done

将脚本保存为run_tox_fastfail.sh，赋予执行权限后运行：chmod +x run_tox_fastfail.sh && ./run_tox_fastfail.sh

Python脚本示例（跨平台） #

import subprocess
import sys

# 定义要运行的TOX环境列表
envs = ["py38", "py39", "py310", "flake8"]

for env in envs:
    print(f"Running tests for environment: {env}")
    result = subprocess.run(["tox", "-e", env])
    if result.returncode != 0:
        print(f"Environment {env} failed, aborting remaining tests")
        sys.exit(1)

保存为run_tox_fastfail.py，运行：python run_tox_fastfail.py

这两种方法都能实现“某一项测试失败则停止后续任务”的需求，适配不同使用场景。

内容的提问来源于stack exchange，提问作者Varun Vijaykumar