Ubuntu安装Python 3.7后怎么配置pip和虚拟环境

Mason
Mason
发布时间:2026-11-17| 9人浏览过
原创

针对Ubuntu系统安装Python 3.7后缺少自带pip和虚拟环境支持的问题,本文详细介绍如何补全依赖、独立配置pip工具、创建和激活Python 3.7专用虚拟环境,并提供常见报错排查方案。

在 Ubuntu 上独立安装 Python 3.7(无论是通过 deadsnakes PPA 还是编译源码)后,系统并不会自动为其绑定专属的 pip 命令,也不会自动就绪完整的虚拟环境支持。配置 Python 3.7 的标准解决路径是:保持 Ubuntu 默认 Python 环境不变,为 Python 3.7 独立补齐 python3.7-distutils,利用专属归档脚本完成 pip 安装,并使用 python3.7 -m venv 建立隔离的运行环境。

一、隔离原则:严禁改动系统默认 Python

很多开发者在安装完 Python 3.7 后,习惯尝试通过修改 /usr/bin/python3 软链接或使用 update-alternatives 将全局 python3 切换为 3.7。在 Ubuntu 系统中,这种操作具有很高的系统级破坏风险。

Ubuntu 的底层系统工具(包括软件包管理器 apt、网络配置组件、桌面环境守护程序等)高度依赖发行版出厂自带的 Python 版本(如 Ubuntu 20.04 依赖 Python 3.8,Ubuntu 22.04 依赖 Python 3.10)。一旦强行覆盖全局软链接,将导致这些关键系统工具因语法不兼容或依赖库丢失而直接崩溃。

因此,多版本管理的核心准则是:显式调用,严格隔离。系统全局环境与开发所需的 Python 3.7 环境应各行其道,后续所有命令都必须携带具体的版本号前缀 python3.7 执行。

Ubuntu安装Python 3.7后怎么配置pip和虚拟环境
图 1:Ubuntu 系统默认 Python 与 Python 3.7 隔离共存架构图

二、为 Python 3.7 安装与配置独立 pip

新安装 Python 3.7 后,在终端中执行 python3.7 -m pip,一般会遇到以下报错:

/usr/bin/python3.7: No module named pip

为 Python 3.7 配置 pip 并不是执行普通的 sudo apt install python3-pip,因为该命令只会给 Ubuntu 默认的 Python 版本安装 pip。为 Python 3.7 正确配置 pip 需要完成以下两个具体环节。

1. 补齐依赖:安装 python3.7-distutils

Ubuntu 对 Python 标准库进行了拆包处理。在较新的 Ubuntu 发行版中,Python 3.7 的标准库并不会随解释器完整安装,其中用于构建和打包的 distutils 组件默认缺失。如果不先安装该组件,后续执行 pip 安装脚本时会报出 No module named 'distutils.util'。

若你的 Python 3.7 是通过 deadsnakes PPA 源安装的,需通过 apt 安装对应的 distutils 包:

sudo apt update
sudo apt install -y python3.7-distutils

2. 使用 3.7 专属归档脚本安装 pip

Python 3.7 已经于 2023 年正式退役(EOL)。如果直接下载官方最新的通用 get-pip.py 脚本并运行,会直接遇到版本不兼容的中断提示:This version of Python is no longer supported。

官方为已停止维护的 Python 版本提供了归档支持。需要精确下载对应 3.7 分支的归档安装脚本:

curl -sS https://bootstrap.pypa.io/pip/3.7/get-pip.py -o get-pip.py
sudo python3.7 get-pip.py
rm get-pip.py

3. 验证 pip 安装与版本绑定

安装完成后,不要直接在终端运行裸命令 pip,必须使用 python3.7 -m pip --version 验证该 pip 是否确实与 Python 3.7 解释器绑定:

python3.7 -m pip --version

终端返回的示例输出如下:

pip 24.0 from /usr/local/lib/python3.7/dist-packages/pip (python 3.7)

只要输出末尾明确显示 (python 3.7),即说明 Python 3.7 已经拥有了独立的 pip 包管理器。

可选优化:配置 pip 国内镜像加速源

为避免从海外源拉取依赖缓慢或超时,可以为当前用户配置全局镜像加速:

mkdir -p ~/.pip
cat << 'EOF' > ~/.pip/pip.conf
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com
EOF
Ubuntu安装Python 3.7后怎么配置pip和虚拟环境
图 2:Python 3.7 独立 pip 配置流转流程图

三、为 Python 3.7 创建与管理虚拟环境

即便全局的 python3.7 -m pip 配置完成,日常开发中也不应直接使用 sudo python3.7 -m pip install 安装第三方包。不同项目可能依赖同一模块的不同版本,全局混装会迅速造成依赖地狱。最稳健的方案是通过虚拟环境为每个项目创建自包含的沙箱。

1. 补齐虚拟环境模块支持

Python 3 内置了 venv 模块,但在 Ubuntu 上该模块同样被拆分为独立的包。若直接执行 python3.7 -m venv myenv,往往会报错提示 The virtual environment was not created successfully because ensurepip is not available。

可以通过系统包管理器补充 python3.7-venv:

sudo apt install -y python3.7-venv

备选方案:如果所使用的 Ubuntu 源没有提供 python3.7-venv,可以借助刚刚配好的 pip 直接安装 virtualenv 作为替代方案:

python3.7 -m pip install virtualenv

2. 创建项目专属虚拟环境

进入项目所在路径,使用 Python 3.7 创建名为 .venv(或自定义名称如 myenv37)的虚拟环境目录:

# 进入或创建项目目录
mkdir -p ~/projects/demo_py37
cd ~/projects/demo_py37

# 方式一:使用内置 venv 模块
python3.7 -m venv .venv

# 方式二:若使用 virtualenv 替代方案
python3.7 -m virtualenv .venv

3. 激活与使用虚拟环境

创建完成后,当前项目目录下会生成一个完整的沙箱文件夹。执行激活脚本:

source .venv/bin/activate

激活成功后,终端命令行最前端会出现虚拟环境标识 (.venv)。此时,环境变量 $PATH 已经被临时重写,当前终端环境中的 python 和 pip 已经自动指向该虚拟环境内部:

# 验证当前 python 路径
which python
# 示例输出:/home/ubuntu/projects/demo_py37/.venv/bin/python

# 验证当前版本
python -V
# 示例输出:Python 3.7.17

# 验证当前 pip 路径
which pip
# 示例输出:/home/ubuntu/projects/demo_py37/.venv/bin/pip

在激活状态下,可以直接执行 pip install <package>,无需添加 sudo。所有安装的模块都将存放在 .venv/lib/python3.7/site-packages 下,完全不触碰系统目录。

4. 退出与销毁虚拟环境

当完成开发任务需要切换回系统默认状态时,只需在终端中执行:

deactivate

终端提示符前缀的 (.venv) 随即消失,PATH 环境变量自动恢复原样。如果需要销毁该虚拟环境,直接递归删除该目录即可,无需卸载任何系统包:

rm -rf .venv
Ubuntu安装Python 3.7后怎么配置pip和虚拟环境
图 3:Python 3.7 虚拟环境目录构成与运行隔离机制原理图

四、常见报错与排查清单

在实际操作中,由于 Ubuntu 发行版代数(18.04、20.04、22.04)和初始环境差异,读者常会遇到以下几类典型报错,可按对应方案快速排查:

1. 报错:No module named 'distutils.util'

  • 触发场景:执行 python3.7 get-pip.py 或创建虚拟环境时。
  • 原因分析:Ubuntu 官方打包将标准库的 distutils 剥离成了独立包,未默认随解释器安装。
  • 解决方案:执行 sudo apt update && sudo apt install -y python3.7-distutils。

2. 报错:ensurepip is not available in Python

  • 触发场景:执行 python3.7 -m venv myenv 时。
  • 原因分析:标准虚拟环境生成需要 ensurepip 支持,而 Ubuntu 同样将该功能拆入单独的 venv 包。
  • 解决方案:执行 sudo apt install -y python3.7-venv;若源中无此包,可先通过 pip 安装 virtualenv(python3.7 -m pip install virtualenv),改用 python3.7 -m virtualenv myenv 创建。

3. 报错:This version of Python is no longer supported

  • 触发场景:直接使用网络上常见的 curl https://bootstrap.pypa.io/get-pip.py | sudo python3.7。
  • 原因分析:主线最新的 get-pip.py 已经移除了对 Python 3.7 的兼容。
  • 解决方案:严格使用归档路径:https://bootstrap.pypa.io/pip/3.7/get-pip.py。

4. 现象:虚拟环境激活后输入 pip 仍提示权限不足并尝试写入全局

  • 触发场景:在激活状态下不小心敲了 sudo pip install ...。
  • 原因分析:sudo 命令会在特权 root 环境下运行,root 用户的环境变量中并不包含当前普通用户的虚拟环境 PATH,导致命令逃逸出沙箱,去调用了系统全局 pip。
  • 解决方案:在虚拟环境中安装依赖时,严禁加 sudo,直接使用 pip install 即可。
Ubuntu安装Python 3.7后怎么配置pip和虚拟环境
图 4:Python 3.7 配置常见故障排查与速查总结决策卡

五、全篇总结

在 Ubuntu 上为 Python 3.7 配置 pip 与虚拟环境,本质上是一套“解耦与补全”的流程:

  1. 依赖补全:利用 sudo apt install python3.7-distutils python3.7-venv 填补 Ubuntu 官方对标准库的拆包空缺。
  2. 工具就绪:从 https://bootstrap.pypa.io/pip/3.7/get-pip.py 获取兼容 Python 3.7 的专属安装器,通过 python3.7 get-pip.py 安装,并通过 python3.7 -m pip --version 验证绑定。
  3. 沙箱开发:进入具体项目后始终通过 python3.7 -m venv .venv 建立隔离环境,使用 source .venv/bin/activate 激活后进行无污染依赖管理。

遵循这套规范,既能让老旧的 Python 3.7 依赖平稳运行,又能完全保障 Ubuntu 宿主操作系统的稳定与安全。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。