为什么Python虚拟环境中用pip安装的依赖在外部环境也能显示？

核心原因 #

• 安装依赖时指定了--user参数：只要执行pip install时带上--user参数，无论虚拟环境是否激活，依赖都会被安装到当前用户的全局用户库目录（通常为~/.local/lib/pythonX.Y/site-packages），该目录默认会被全局、虚拟环境的Python解释器同时读取，因此两边查看到的包列表一致。
• 创建虚拟环境时开启了全局包继承：如果执行python3 -m venv时添加了--system-site-packages参数，虚拟环境会默认读取全局解释器的所有安装包，同时如果虚拟环境没有配置独立的安装路径，新安装的包也可能写入全局目录。
• pip全局配置强制指定了安装路径：如果本地pip配置文件（~/.pip/pip.conf、~/.config/pip/pip.conf等）中配置了target、install-option等参数强制指定安装到全局路径，会覆盖虚拟环境的默认安装路径。
• Shell命令缓存未更新：部分Shell（如Bash）会缓存可执行文件的路径，若激活虚拟环境前已经执行过python3/pip3命令，激活后Shell可能仍然调用系统全局的Python解释器而非虚拟环境内的版本。
• PYTHONPATH环境变量优先级过高：如果当前环境的PYTHONPATH变量中硬编码了全局site-packages的路径，该路径的加载优先级会高于虚拟环境的包目录，导致所有Python解释器优先读取全局包。

快速排查方法 #

• 激活虚拟环境后执行which python3，确认返回路径为当前虚拟环境内的env/bin/python3，若返回系统路径可执行hash -r清除Shell缓存后重试。
• 执行pip config list检查是否有全局配置强制指定了安装路径。
• 执行echo $PYTHONPATH检查是否有全局包目录被强制加入路径。
• 在虚拟环境内安装测试包，执行pip show <测试包名>查看Location字段，确认是否落在虚拟环境的env/lib/pythonX.Y/site-packages目录下。

内容的提问来源于stack exchange，提问作者A.K.M. Adib