解决Python报错：error: uninstall-distutils-installed-package × Cannot uninstall some_package

前言

在使用 Python，安装依赖时，报错：

error: uninstall-distutils-installed-package × Cannot uninstall PyYAML 5.3.1 ╰─> It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall. [notice] A new release of pip is available: 24.1.1 -> 25.0.1 [notice] To update, run: python3.10 -m pip install --upgrade pip

错误原因

distutils 是 Python 中一个较旧的包安装工具，它不像 pip 或 setuptools 那样记录安装文件的详细列表，因此，pip 无法准确判断哪些文件属于 PyYAML，导致无法完全卸载它，只会进行部分卸载。

解决方法

由于 pip 无法直接卸载通过 distutils 安装的 PyYAML，我们可以使用 pip 的 --ignore-installed 标志来绕过这个问题。

这个标志告诉 pip 忽略现有的安装，直接安装新版本的包，从而覆盖旧版本的文件。

pip install --ignore-installed some_package

这会安装 PyYAML 的最新版本，覆盖现有的 distutils 安装。

为什么这个方法有效？

• 当 pip 升级或安装包时，它通常会先尝试卸载旧版本，然后安装新版本。
• 对于通过 distutils 安装的包（如 PyYAML 5.3.1），卸载步骤会失败，因为 pip 无法找到完整的文件列表。
• 使用 --ignore-installed 后，pip 会跳过卸载步骤，直接安装新版本，覆盖旧版本的文件。
• 对于像 PyYAML 这样的纯 Python 包，这种覆盖通常是安全的，不会留下严重冲突。

关于 pip 更新提示

错误信息中提到的 pip 更新（从 24.1.1 到 25.0.1），在问题解决后，运行以下命令更新 pip：

python3.10 -m pip install --upgrade pip