使用 tox 管理多 Python 版本测试环境

tox是一个自动化测试工具，用于在多个Python版本中验证代码兼容性。它基于virtualenv和pip创建隔离环境，通过tox.ini配置文件定义测试环境，支持跨版本测试、条件依赖安装及与CI/CD集成。示例配置包括指定Python版本列表（envlist）、测试依赖（deps）和执行命令（commands），还可扩展至lint和typecheck等自定义环境。在CI中只需安装tox并运行tox命令即可完成自动化测试，前提是CI环境已安装所需Python版本。使用tox能显著提升项目健壮性和维护效率。

在项目开发中，确保代码能在多个 Python 版本中正常运行非常重要。tox 是一个自动化测试环境管理工具，能帮你轻松在不同 Python 解释器版本下运行测试，验证兼容性。

什么是 tox

tox 是一个命令行工具，用于封装和自动化 Python 项目的测试流程。它基于 virtualenv 和 pip，可以自动创建隔离环境，安装依赖，并在指定的 Python 版本中执行测试命令。

它的核心优势是：跨版本测试、配置驱动、与 CI 集成方便。

安装与基本使用

pip install tox

立即学习“Python免费学习笔记（深入）”；

在项目根目录创建配置文件：

tox 默认读取 tox.ini 文件来定义测试环境。

一个基础的 tox.ini 示例：

[tox]
envlist = py38,py39,py310,py311
<p>[testenv]
deps = pytest
commands = pytest tests/</p>

说明：

• envlist 定义要测试的 Python 版本环境
• [testenv] 是通用测试环境配置
• deps 指定测试时需要安装的依赖
• commands 是在每个环境中执行的命令

运行测试：

tox

tox 会依次为每个 env 创建虚拟环境，安装依赖，并运行测试命令。

Dreamhouse AI

AI室内设计，快速重新设计你的家，虚拟布置家具

78

查看详情

配置多版本与条件依赖

如果你的项目依赖因 Python 版本而异，可以在 deps 中使用条件表达式。

示例：

[testenv]
deps =
    pytest
    typing_extensions ; python_version < "3.8"
commands = pytest tests/

这里，typing_extensions 只在 Python 3.8 以下版本安装。

你也可以自定义环境名称，比如加入 type checking：

envlist = py38,py39,py310,py311,lint,typecheck
<p>[testenv:lint]
basepython = python3.11
deps = flake8
commands = flake8 src/</p><p>[testenv:typecheck]
basepython = python3.11
deps = mypy
commands = mypy src/</p>

这样 lint 和 typecheck 使用特定版本解释器，不随其他环境变动。

集成到 CI/CD

tox 特别适合与 GitHub Actions、GitLab CI 等集成。

CI 系统中只需安装 tox 并运行 tox 命令，就能自动完成多版本测试。

前提是在 CI 环境中已安装所需的 Python 版本（如通过 pyenv 或系统包管理）。

GitHub Actions 示例片段：

- name: Run tox
  run: |
    pip install tox
    tox

确保 tox.ini 中列出的 Python 版本在 CI 运行器中可用。

基本上就这些。用好 tox 能大幅简化多版本测试流程，提升项目健壮性和可维护性。

以上就是使用 tox 管理多 Python 版本测试环境的详细内容，更多请关注php中文网其它相关文章！