如何正确使用tox多环境测试？pyenv下py310无法调用问题

出现py310环境被跳过的核心原因是tox无法定位到对应的Python 3.10解释器，具体可能为以下几点：

• pyenv环境变量配置不全：pyenv的shims目录未被加入系统PATH最前端，导致tox优先查找系统自带Python，而非pyenv管理的版本。
• Python 3.10未激活：pyenv安装版本后，需通过global或local命令激活，否则shims目录不会生成python3.10软链，tox无法识别。
• tox版本过旧：旧版本tox对pyenv的版本识别支持不完善，无法自动关联pyenv安装的Python版本。
• 软链缺失：极少数情况下，pyenv安装Python 3.10.1后未自动创建python3.10软链，导致tox无法匹配py310环境。

1. 安装并配置pyenv #

依赖准备（以Debian/Ubuntu为例） #

sudo apt update && sudo apt install git build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl libncursesw5-dev xz-utils \
tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

安装pyenv #

git clone https://github.com/pyenv/pyenv.git ~/.pyenv

配置环境变量 #

根据你的shell类型修改对应配置文件：

• bash：编辑~/.bashrc，添加以下内容：

  export PYENV_ROOT="$HOME/.pyenv"
  command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
  eval "$(pyenv init -)"
  

• zsh：编辑~/.zshrc，添加同样内容。

保存后执行source ~/.bashrc（或对应shell配置文件）使配置生效。

2. 安装指定Python版本 #

# 更新pyenv版本列表
pyenv update

# 安装Python 3.9.16
pyenv install 3.9.16

# 安装Python 3.10.1
pyenv install 3.10.1

# 验证安装结果
pyenv versions

3. 激活Python版本 #

选择以下一种激活方式即可：

• 全局激活：所有终端会话生效

  pyenv global 3.9.16 3.10.1
  

• 本地激活：仅当前项目目录生效（推荐）

  cd /path/to/your/project
  pyenv local 3.9.16 3.10.1
  

验证激活结果：

python --version
python3.10 --version

4. 安装tox #

推荐用pipx安装避免全局污染：

# 先安装pipx（未安装时）
python -m pip install --user pipx
python -m pipx ensurepath

# 安装tox
pipx install tox

若用pip全局安装：

pip install --upgrade tox

验证tox版本：

tox --version

5. 配置tox.ini #

在项目根目录创建tox.ini，示例配置如下（根据测试框架调整）：

[tox]
envlist = py39, py310
skipsdist = true  # 无需打包时跳过dist构建

[testenv]
commands = pytest tests/  # 测试命令，替换为你的实际命令
deps =
    pytest>=7.0.0
    requests>=2.28.0  # 测试依赖，按需添加

6. 运行tox #

在项目根目录执行：

tox

此时tox应能正确识别py39和py310环境，完成两个版本的测试。

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