tox配置pip>=22与tox-pipenv时触发Python版本识别报错

这个报错和你怀疑的方向沾边，但本质是两个配置错误叠加了tox-pipenv的老bug触发的：

• 第一，[tox]配置段的requires字段，作用是声明运行tox程序本身需要的插件和依赖，这些包会被装到tox自己的隔离运行环境（就是报错里的.tox/.tox/目录），根本不会装到你跑测试用的py3目标虚拟环境里。你把pip >=22.0.0写在这里，完全达不到升级测试环境pip的目的。
• 第二，低版本tox-pipenv有参数解析bug：当requires段同时放了tox插件和其他普通Python包时，它会拼错执行命令，把普通包的版本约束字符串错当成Python解释器路径，传给pipenv --python参数，最后执行版本号解析的时候，把路径字符串当整数转换，就抛出了你看到的ValueError。

按顺序走就能快速定位问题：

• 先把[tox].requires里除了tox插件之外的依赖全部注释掉，重新运行tox，看报错是否消失——这一步可以直接验证是不是tox-pipenv的参数解析问题
• 确认pip升级的作用域：要升级测试虚拟环境里的pip，配置必须写在[testenv]段下，不能写到全局tox配置里
• 单独在手动创建的虚拟环境里验证，用>=22版本的pip执行pip install -e <pkg-path>确实能安装成功，排除包本身的安装问题

二选一即可，优先推荐第二种，稳定性更高。

方案1：保留tox-pipenv，修正配置 #

把pip从全局requires里移除，放到测试环境的依赖列表最前面，确保先升级pip再装其他包，修正后的配置：

[tox]
envlist = py3
requires =
    tox-pipenv >= 1.10
; 注意：这个段落只放tox运行需要的插件，不要放测试业务相关的依赖

[testenv]
deps =
    pip >= 22.0.0
    -e <pkg-path>
; 如果执行时还是用老版本pip装editable包报错，就打开下面的install_command配置，强制先升级pip
; install_command = python -m pip install --upgrade pip>=22.0.0 && python -m pip install {opts} {packages}
commands =
    # 填你自己的测试命令
    ...

如果改完配置还是报参数解析的错，直接把tox-pipenv升到最新版就行，这个参数拼接的bug在后续版本已经修复了。

方案2：移除tox-pipenv，用tox原生能力（推荐） #

tox从3.x版本开始就原生支持虚拟环境创建、依赖安装全流程，tox-pipenv已经很久没有大的维护更新了，很容易出兼容性问题。去掉这个插件之后配置更简单，完全对齐你本地手动操作的流程：

[tox]
envlist = py3
min_version = 3.18.0 ; 保证基础的PEP660安装支持

[testenv]
deps =
    pip >= 22.0.0
    -e <pkg-path>
commands =
    # 填你自己的测试命令
    ...

这个配置跑的时候，tox会自动创建py3虚拟环境，先把pip升级到符合要求的版本，再以editable模式安装目标包，完全支持没有setup.py、只用pyproject.toml的现代Python包的editable安装，不会出参数解析的奇怪问题。

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