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 集成方便。
安装与基本使用
安装 tox：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 创建虚拟环境，安装依赖，并运行测试命令。
配置多版本与条件依赖
如果你的项目依赖因 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 能大幅简化多版本测试流程，提升项目健壮性和可维护性。
