Ubuntu 中 Python venv 创建失败及 ensurepip 报错修复指南

报错现象与原因定位

在使用命令行初始化虚拟环境时，终端通常会抛出类似以下的错误信息：

Error: Command '['****/env/bin/python3.11', '-m', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1.

该错误表明 venv 模块在尝试调用内部打包工具 ensurepip 时中断。为明确缺失的具体位置，可手动触发该模块进行诊断：

python3.11 -m ensurepip --upgrade --default-pip

此时终端会直接输出：/usr/bin/python3.11: No module named ensurepip。这证实了当前操作系统级别的 Python 3.11 安装不完整，缺少驱动虚拟环境启动的核心依赖包。

修复操作顺序

第1步：核对系统版本与源状态

由于 Ubuntu 官方软件源版本迭代较快，不同发行版（如 20.04、22.04 或 24.04）对 Python 子包的命名可能略有差异。在执行安装前，建议先刷新本地缓存，确保能拉取最新软件列表：

sudo apt update

此步骤旨在避免因源过期导致后续安装包下载失败。

第2步：安装缺少的 venv 依赖组件

根据诊断结果，直接通过 apt 管理器补齐对应版本的虚拟环境支持库。请务必替换版本号以匹配实际使用的 Python 核心：

sudo apt install python3.11-venv

执行后按回车确认安装。该操作将安全写入系统路径，不会覆盖现有的 Python 解释器或其他第三方库。如需同时管理多个版本，可依次追加对应后缀（如 python3.10-venv）。

第3步：重建虚拟环境并验证

依赖安装完成后，清除之前未成功生成的残缺目录，重新运行初始化命令：

rm -rf env
python3.11 -m venv env

若无报错输出，即表示创建成功。可切换至新建目录并激活环境进行最终校验：

cd env && source bin/activate
python3.11 --version

当终端显示正确的 Python 版本号且提示符前缀变更为 (env) 时，代表虚拟环境已完全恢复正常。

排查建议与注意事项

部分开发者习惯从官网编译安装 Python，而本方案基于 Debian/Ubuntu 系的 apt 机制。若您的环境源自源码编译（Source Build），则需在编译阶段加入 --enable-ensurepip 参数。此外，在多版本共存场景下，请严格区分 python 与 python3.11 指向的底层二进制文件，避免误装其他版本的依赖包影响全局工作流。

以上就是 Ubuntu 下 Python venv 创建失败及 ensurepip 报错的详细解决步骤，更多关于 Linux 环境下 Python 虚拟环境配置的资料请关注本站其它相关文章！