Ubuntu 上 Python 3.10 的 pip 安装与问题解决

问题描述

在 Ubuntu 系统中安装 Python 3.10 后，尝试使用 python3.10 -m pip install <包名> 时出现以下错误：

ImportError: cannot import name 'html5lib' from 'pip._vendor' (/usr/lib/python3/dist-packages/pip/_vendor/__init__.py)

这个错误通常是由于系统中已安装的 pip 版本过旧，与 Python 3.10 不兼容导致的。当系统同时存在多个 Python 版本时，pip 的版本冲突问题尤为常见。

注意

直接使用 sudo apt-get install python3-pip 安装的 pip 通常是针对系统默认 Python 版本的，可能无法兼容 Python 3.10。

解决方案

以下是几种有效的解决方法，可根据具体情况选择适合的方案。

方案一：使用官方引导脚本安装 pip（推荐）

这是最直接且可靠的解决方法，适用于大多数情况：

curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

安装完成后验证 pip 版本：

python3.10 -m pip --version

如果需要升级 pip：

python3.10 -m pip install --upgrade pip

权限问题

如果遇到权限错误，可尝试使用 sudo 或以用户模式安装：

# 使用 sudo（可能影响系统全局环境）
curl -sS https://bootstrap.pypa.io/get-pip.py | sudo python3.10

# 用户模式安装（推荐，不影响系统环境）
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

方案二：使用 ensurepip 安装

如果上述方法无效，可以尝试使用 Python 内置的 ensurepip 模块：

python3.10 -m ensurepip

安装完成后同样可以升级 pip：

python3.10 -m pip install -U pip

方案三：安装必要的依赖包

在某些情况下，需要安装 Python 3.10 的 distutils 包：

sudo apt install python3.10-distutils

方案四：添加 deadsnakes PPA 源

如果需要安装更新的 Python 3.10 版本或相关工具，可以添加 deadsnakes PPA 源：

sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update

然后安装 Python 3.10 和相关组件：

sudo apt install python3.10 python3.10-venv python3.10-distutils

使用虚拟环境（最佳实践）

为了避免不同 Python 版本和包之间的冲突，建议使用虚拟环境：

# 安装虚拟环境支持
sudo apt install python3.10-venv

# 创建虚拟环境
python3.10 -m venv myenv

# 激活虚拟环境
source myenv/bin/activate

# 在虚拟环境中安装包
pip install <package-name>

# 退出虚拟环境
deactivate

创建别名简化操作

如果经常使用 Python 3.10 的 pip，可以在 ~/.bashrc 中添加别名：

echo "alias pip310='python3.10 -m pip'" >> ~/.bashrc
source ~/.bashrc

之后就可以直接使用：

pip310 install <package-name>

故障排除

如果仍然遇到问题，可以尝试以下步骤：

1. 检查 Python 版本：

   python3.10 --version

2. 移除冲突的 pip 安装：

   sudo apt remove python3-pip

3. 检查 PATH 环境变量： 确保 ~/.local/bin 在 PATH 中，新安装的 pip 可能位于此目录。

总结

Ubuntu 上 Python 3.10 的 pip 问题通常是由于系统自带的 pip 版本过旧导致的。通过官方引导脚本安装最新版 pip 是最可靠的解决方法。为了避免未来的版本冲突，建议使用虚拟环境管理项目依赖。

版本兼容性

本文提供的解决方案适用于 Ubuntu 18.04、20.04 和 22.04 等常见版本，以及 Python 3.10 的各子版本。