如何阻止setup.py使用系统路径中的Python依赖包？

看起来你的虚拟环境虽然配置了PYTHONPATH和PATH，但setuptools/easy_install仍然会读取系统路径下的包，这通常和虚拟环境的隔离配置、工具版本或Python默认路径规则有关，下面是具体的排查和解决步骤：

可能的原因 #

• 虚拟环境创建时意外启用了--system-site-packages选项，导致Python优先加载系统site-packages中的包
• 虚拟环境内的setuptools版本依赖了系统级配置，或者easy-install.pth文件中已存在系统包的引用
• Python解释器的sys.path默认包含系统site-packages路径，即使你设置了PYTHONPATH也会被自动添加

解决步骤 #

1. 确认虚拟环境的隔离状态 #

先检查当前激活的虚拟环境是否真的隔离了系统包：

# 确认当前使用的Python是虚拟环境内的
which python
# 正常输出应为 ~/virtualenv/bin/python

# 查看Python的sys.path路径列表
python -c "import sys; print('\n'.join(sys.path))"

如果输出中包含/opt/common/.../site-packages，说明虚拟环境未完全隔离，建议重新创建：

# 先退出当前虚拟环境
deactivate
# 备份重要文件后删除旧虚拟环境
rm -rf ~/virtualenv
# 创建全新的隔离虚拟环境
virtualenv ~/virtualenv
# 重新激活环境
source ~/virtualenv/bin/activate

2. 升级虚拟环境内的工具版本 #

系统级的setuptools可能干扰虚拟环境的依赖处理，先确保环境内的工具是最新的：

source ~/virtualenv/bin/activate
python -m pip install --upgrade pip setuptools wheel

3. 强制将系统依赖安装到虚拟环境 #

对于已经被检测到的系统包（比如PyYAML），直接用pip强制重新安装到虚拟环境：

pip install PyYAML==3.12 --force-reinstall

这会把PyYAML包安装到~/virtualenv/lib/python2.7/site-packages，并覆盖easy-install.pth中的系统包引用。

4. 优先用pip替代setup.py安装 #

相比python setup.py install，pip的依赖处理更严格，会优先使用虚拟环境内的包：

# 激活环境后执行
pip install .

# 如果需要开发模式（修改代码后无需重新安装）
pip install -e .

5. 临时禁用系统site-packages（可选） #

如果问题仍存在，可以在运行setup.py前设置环境变量，让Python忽略系统和用户的site-packages：

PYTHONNOUSERSITE=1 python setup.py install

验证结果 #

安装完成后，检查包的实际路径：

python -c "import yaml; print(yaml.__file__)"

输出指向~/virtualenv/lib/python2.7/site-packages/yaml/...即说明已成功使用虚拟环境内的包。

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