求助：Tox未创建干净独立虚拟环境，依赖继承自全局环境的问题

我目前的工作流程是这样的：

• 我有一个requirements.txt，里面包含tox和其他很多包
• 先创建并激活全局虚拟环境：

  python3 -m venv global_env  
  source global_env/bin/activate  
  pip install -r requirements.txt
  

• 接着写了tox.ini配置文件，在Jenkinsfile里调用不同的环境，配置如下：

  [tox]
  envlist = py3.10.12, linter, unit-tests, docs 
  skipsdist = true
  
  [testenv]
  allowlist_externals = pytest, sphinx-build
  deps = 
      -rrequirements.txt
  [testenv:linter]
  description = Run Black linter
  deps  = 
      black
  commands = 
      black mtqe/ --check 
  
  [testenv:unit-tests]
  description = Run unit tests
  deps = 
      {[testenv]deps}
  commands =
      pytest ./tests/ --disable-warnings
  

我原本理解tox会创建完全干净的独立环境来运行测试，但实际情况不是这样——所有tox环境都继承了global_env的依赖。我做了测试：把requirements.txt里的一些包删掉，原本预期单元测试会失败，但结果并没有，这说明tox还是在使用全局环境里的依赖。

问题分析与解决方案 #

你遇到的问题大概率是因为在激活全局虚拟环境的状态下运行了tox，tox默认会继承当前环境的PYTHONPATH等环境变量，导致它没有完全隔离出干净的环境。给你几个实用的解决思路：

1. 退出全局虚拟环境后再运行tox

最简单直接的方法：先执行deactivate退出global_env，然后直接运行tox。这样tox会完全独立创建自己的虚拟环境，不会受到当前激活环境的干扰。

2. 在tox.ini里强制开启环境隔离

可以在[testenv]段添加关键配置，强制tox忽略外部环境的影响：

[testenv]
# 禁用继承外部环境的site-packages，确保环境干净
sitepackages = false
# 忽略外部Python环境的冲突，强制使用指定版本创建环境
ignore_basepython_conflict = true
allowlist_externals = pytest, sphinx-build
deps = 
    -rrequirements.txt

其中sitepackages = false是核心配置，它会确保tox创建的虚拟环境完全不包含全局（或当前激活虚拟环境）的site-packages内容，所有依赖都会从头安装。

3. 优化tox的安装方式

另外，建议不要在项目的虚拟环境里安装tox，而是用全局环境安装，或者更推荐用pipx来安装tox——这样tox本身也运行在独立环境中，从根源上避免和项目环境产生依赖交叉。

验证环境是否干净的方法

修改配置或调整运行方式后，可以进入tox生成的虚拟环境目录（默认在项目根目录的.tox/[环境名]/lib/python3.10/site-packages），查看里面的包列表，确认只有requirements.txt和各个testenv指定的依赖，就能验证环境是否完全隔离了。

备注：内容来源于stack exchange，提问作者LearnToGrow