如何正确处理pip与distutils库的版本冲突问题？

这个问题我太熟悉了！pip 10.0.0版本开始对通过distutils安装的系统级包做了严格保护，防止误删导致系统异常，所以才会弹出那个Cannot uninstall '***'. It is a distutils installed project...的提示。下面分享几个实测有效的解决办法，你可以根据自己的场景选择：

1. 跳过冲突包直接安装目标依赖 #

如果你的核心需求是安装某个新包，只是因为这些系统包版本不兼容导致失败，最简单的办法就是让pip忽略已安装的冲突包：

pip install 你的目标包 --ignore-installed PyYAML pyOpenSSL urllib3 chardet

小贴士：这个操作不会卸载系统里的旧包，只是强制安装新包到用户目录（如果搭配--user参数）或者覆盖当前环境，适合不需要替换系统依赖的场景。

2. 彻底替换系统包为pip管理版本（谨慎操作） #

如果你确定要把这些包换成pip维护的版本，可以先通过系统包管理器卸载对应的系统包：

• 对于Debian/Ubuntu系列：

sudo apt-get remove python-yaml python-openssl python-urllib3 python-chardet

• 对于RHEL/CentOS系列：

sudo yum remove python-yaml pyOpenSSL python-urllib3 python-chardet

卸载完成后，再用pip重新安装你需要的版本：

pip install PyYAML pyOpenSSL urllib3 chardet --upgrade

⚠️ 重要警告：很多系统工具（比如系统脚本、运维工具）依赖这些系统包，卸载前一定要确认不会影响系统正常运行！建议先在测试环境验证，或者做好备份。

3. 用虚拟环境隔离依赖（最推荐） #

这是最安全的方案，完全隔离系统Python和项目依赖，根本不会碰到冲突问题：

1. 创建并激活虚拟环境：

# Python 3.x
python3 -m venv my_project_env
source my_project_env/bin/activate

# Python 2.x（需先安装virtualenv）
pip install virtualenv
virtualenv my_project_env
source my_project_env/bin/activate

2. 在虚拟环境里直接安装所有需要的包，完全不受系统包影响：

pip install 你的目标包 PyYAML pyOpenSSL urllib3 chardet --upgrade

虚拟环境的好处就是可以随便折腾，出问题直接删掉环境就行，完全不会影响系统全局的Python环境，强烈推荐开发场景用这个方法。

4. 临时降级pip（迫不得已的方案） #

如果以上方法都不适用，你可以暂时把pip降级到10.0.0之前的版本，绕过这个校验：

pip install pip==9.0.3

不过这只是临时解决办法，不推荐长期使用——毕竟新版本的pip修复了很多安全漏洞和bug，能升级还是尽量升级。

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