python-mvenv失败提示ensurepip缺失怎么解决？

一、现象识别：为什么执行 venv 会提示 ensurepip 缺失？

在 Linux 终端中运行创建虚拟环境的标准命令时，常常会直接遭遇如下阻断：

python3 -m venv .venv

The virtual environment was not created successfully because ensurepip is not
available.  On Debian/Ubuntu systems, you need to install the python3-venv
package using the following command.

    apt-get install python3-venv

You may need to use sudo with that command.  Alternatively, if you want to
create the environment without pip, you can use the --without-pip switch:

    python3 -m venv --without-pip .venv

从 Python 的标准设计来看，venv 模块自 Python 3.3 起便内置于标准库中，它的核心职能包含两部分：一是在目标目录下构建孤立的目录树与符号链接，二是通过内置的 ensurepip 模块将 pip 与 setuptools 自动安装（自举引导，Bootstrap）到该虚拟环境中。

然而在 Debian、Ubuntu、Linux Mint 等系统的官方软件仓库中，维护者出于精简基础运行库体积、规避包管理器与 pip 文件冲突等设计规范，对官方 CPython 进行了分拆打包。基础的 python3 软件包仅包含精简解释器与部分核心库，ensurepip 代码与其携带的预打包 wheel 文件被剥离并单独移入了 python3-venv（或特定版本的 python3.x-venv）包中。因此，当系统只安装了 python3 而未安装配套的虚拟环境扩展包时，创建虚拟环境的自举阶段便会触发中断。

二、方案一：通过系统包管理器安装 python3-venv（推荐首选）

只要当前拥有目标机器的 sudo 或 root 权限，最规范、最省力的修复方式就是直接安装对应版本的系统包。需要注意的是，必须保证安装的扩展包版本与当前正在运行的 Python 解释器版本完全吻合。

步骤 1：精确确认当前使用的 Python 版本

在安装前，请通过终端查看当前环境默认调用的 Python 版本号：

python3 --version

Python 3.10.12

步骤 2：执行包安装命令

根据您的 Linux 发行版与具体的 Python 版本，选择对应的安装命令：

1. Ubuntu / Debian / Linux Mint 系统

如果使用的是系统默认安装的 Python 3（通常直接通过 python3 调用），直接运行：

sudo apt update
sudo apt install -y python3-venv

# 针对 python3.11
sudo apt install -y python3.11-venv

# 针对 python3.12
sudo apt install -y python3.12-venv

2. RHEL / CentOS / Rocky Linux / AlmaLinux / Fedora 系统

在基于 RedHat 的发行版中，相关模块通常整合在 python3-pip 或 python3-virtualenv 中：

sudo dnf install -y python3-pip python3-virtualenv

sudo yum install -y python3-pip python3-virtualenv

3. Arch Linux / Manjaro 系统

Arch 体系通常保持紧贴官方上游打包，但若出现类似自举缺失，可执行：

sudo pacman -S python-virtualenv python-pip

三、方案二：无 root 权限或轻量容器环境下的双阶段引导

在共享服务器、学校集群、被限制权限的 CI/CD 容器或只读文件系统中，开发者往往无法调用 sudo apt install。针对这种场景，Python 官方设计了备用分支路线：先在跳过 pip 的前提下构建出纯净的虚拟环境，随后通过独立的官方安装脚本将 pip 植入其中。

阶段一：附加 --without-pip 参数创建纯净环境

在创建命令中添加 --without-pip 参数，告知 venv 跳过调用缺失的 ensurepip 模块：

python3 -m venv --without-pip myenv

此时命令将顺利执行完毕，不会出现报错。但请注意：此时的 myenv/bin/ 目录下只有 python 与 activate 脚本，尚未具备 pip 工具，无法直接使用 pip install 安装第三方包。

阶段二：使用 get-pip.py 为虚拟环境独立安装 pip

利用 Python 官方维护的 get-pip.py 启动器，直接使用该虚拟环境内置的 Python 解释器执行安装，将 pip 注入到虚拟环境中：

curl -sS https://bootstrap.pypa.io/get-pip.py | ./myenv/bin/python

# 1. 下载脚本
curl -O https://bootstrap.pypa.io/get-pip.py

# 2. 指定虚拟环境内的解释器运行（切勿使用全局 python3）
./myenv/bin/python get-pip.py

# 3. 清理下载的临时脚本文件
rm get-pip.py

四、方案三：源码自编译 Python 环境下的修复

如果您是在 Linux 上手动下载 Python 源码（如 Python-3.x.x.tar.xz）自行编译安装时遭遇此问题，通常是因为编译阶段缺少了必要的底层开发依赖包，导致内置的 ensurepip 模块在编译期被静默禁用或构建失败。

1. 补齐编译前置依赖

在编译前，必须确保系统已安装完整的依赖项（特别是 zlib 与 openssl，缺少这两项将直接导致 pip 打包和 HTTPS 下载模块无法启用）：

sudo apt install -y build-essential zlib1g-dev libssl-dev libffi-dev libbz2-dev libsqlite3-dev

2. 携带 ensurepip 参数重新编译安装

在执行 ./configure 配置时，确认不要传递 --without-ensurepip 参数（默认情况下即启用）：

./configure --enable-optimizations --with-ensurepip=upgrade
make -j $(nproc)
sudo make altinstall

3. 手动尝试全局激活 ensurepip

若源码已编译完成但解释器内未自举，可直接尝试调用模块自身：

python3 -m ensurepip --default-pip

若该命令执行成功，则表明 ensurepip 模块已修复，后续即可正常使用 python3 -m venv。

五、结果验证与排查总结

无论采取上述哪一种修复方式，完成操作后都应当按照以下标准化步骤进行验证，确保虚拟环境不仅能“创建成功”，而且能“正常联网安装依赖”：

1. 创建并激活虚拟环境

# 1. 重新创建虚拟环境
python3 -m venv .venv

# 2. 激活虚拟环境
source .venv/bin/activate

2. 检查解释器路径与 pip 可用性

激活后，命令行提示符通常会出现 (.venv) 前缀。此时应执行：

which pip
pip --version

/home/user/project/.venv/bin/pip
pip 22.0.2 from /home/user/project/.venv/lib/python3.10/site-packages/pip (python 3.10)

若 which pip 返回的路径确实位于当前 .venv/bin/ 目录内，而非 /usr/bin/pip 等全局系统目录，即说明虚拟环境与 pip 均已正确挂载就绪。

六、常见场景对照总结

掌握了发行版拆包背后的模块依赖关系后，遇到 ensurepip缺失 报错即可根据当前所处环境的权限和 Python 来源，迅速做出正确的修复决策，顺利搭建起隔离、干净的 Python 开发环境。