旧版Python或ensurepip失效时,怎么通过get-pip.py手动安装

顾言
顾言
发布时间:2026-11-22| 3人浏览过
原创

在旧版Python或标准库ensurepip模块缺失损坏的环境下,通过官方归档的get-pip.py引导脚本手动安装与修复pip的完整操作步骤、版本匹配规则及故障排查方案。

当系统中安装的 Python 缺少 pip,且使用标准命令 python -m ensurepip 提示模块不存在或初始化失败时,官方提供的独立引导脚本 get-pip.py 是最高效的手动安装途径。对于 Python 2.7、3.5、3.6、3.7 等已退役的旧版本,核心关键在于必须从 PyPA 官方归档目录下载对应 Python 版本的历史版 get-pip.py,绝不能直接拉取最新主线脚本,否则会因解释器语法不兼容直接报错中断。

一、为什么会出现 ensurepip 失效或不可用

Python 从 3.4 版本开始将 ensurepip 作为标准库模块引入,旨在离线环境下将解释器附带的 pip 与 setuptools 轮子文件释放到 site-packages。但在实际维护旧系统或特定发行版时,该机制经常失效,主要表现为以下三种常见成因:

  • Linux 发行版拆包策略:Debian、Ubuntu 等系统为了避免 Python 内部包管理器与系统的 apt 发生文件覆盖冲突,默认从标准 Python 运行时中剔除了 ensurepip 模块及其捆绑的 wheel 文件。直接执行时会直接抛出 No module named ensurepip。
  • 精简容器或嵌入式环境裁剪:在基于 Alpine、Debian-Slim 构建的精简 Docker 镜像或 Windows 嵌入式(embeddable zip)安装包中,标准库往往被大幅度瘦身,移除了安装阶段所需的所有辅助工具。
  • 旧版本生命周期终结(EOL):在 Python 2.7、3.5、3.6 等老旧环境中,即便利旧有系统残留了 ensurepip,其内置打包的 pip 版本往往过于古老(如 pip 9 或 10),其依赖的 TLS 协议和索引规范早已无法连通现代 PyPI 服务端,导致自举后依然无法正常拉取模块。
旧版Python或ensurepip失效时,怎么通过get-pip.py手动安装
图 1:ensurepip 常见失效场景及通过 get-pip.py 独立自举的决策机制

二、核心前提:匹配旧版 Python 与 get-pip.py 的归档路由

很多开发者在修复 pip 时遇到的最大误区,是直接复制网络上的命令执行 curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py。

必须明确:位于根路径下的 bootstrap.pypa.io/get-pip.py 永远只支持当前处于活跃支持期(Active/LTS)的现代 Python 版本(通常为 Python 3.8 及以上)。现代版 get-pip.py 内部大量使用了现代语法特性(如 f-string、类型注解、新的异常处理等),同时内置的 pip 轮子早已废弃对旧版解释器的兼容。如果在 Python 2.7 或 Python 3.5/3.6 下直接运行主线脚本,终端会直接输出类似于 SyntaxError: invalid syntax 或 UnsupportedPythonVersion 的致命错误。

为了解决旧环境维护问题,PyPA(Python 官方打包权威机构)在服务端永久归档了各个已停更 Python 版本的最终兼容引导脚本。在下载之前,必须根据目标 Python 版本匹配对应的 URL 分支:

目标 Python 版本 对应 get-pip.py 官方下载地址 最终支持的 pip 版本 环境状态与兼容备注
Python 2.7 https://bootstrap.pypa.io/pip/2.7/get-pip.py pip 20.3.4 EOL 最终支持分支,锁定至 Python 2 终版轮子
Python 3.5 https://bootstrap.pypa.io/pip/3.5/get-pip.py pip 20.3.4 EOL 最终支持分支,停止维护于 2020 年末
Python 3.6 https://bootstrap.pypa.io/pip/3.6/get-pip.py pip 21.3.1 EOL 最终支持分支,停止维护于 2021 年底
Python 3.7 https://bootstrap.pypa.io/pip/3.7/get-pip.py pip 23.0.1 EOL 最终支持分支,停止维护于 2023 年中
Python 3.8+ https://bootstrap.pypa.io/get-pip.py 最新稳定版 官方主线分支,始终随 PyPI 保持滚动更新
旧版Python或ensurepip失效时,怎么通过get-pip.py手动安装
图 2:主流及旧版 Python 对应的 PyPA 官方引导脚本路由对照表

三、手动安装完整实操步骤

安装过程分为精准定位解释器、抓取对应脚本、执行安装命令以及结果校验四个标准阶段。请按实际操作顺序执行以下命令。

步骤一:确认当前 Python 的绝对路径与精确版本

在多版本共存的服务器上,输入 python 可能会命中系统预装的默认解释器,而非你需要安装 pip 的目标版本。先通过具体命令明确解释器路径与次版本号:

# 检查当前终端默认 python 的版本与路径
which python
python --version

# 如果是特定版本(例如已退役的 python3.6 或 python2.7)
which python3.6
python3.6 --version

命令运行后应当明确显示主次版本。例如终端回显 Python 3.6.8,则确认本次需要下载 pip/3.6/get-pip.py 分支。

步骤二:下载对应的 get-pip.py 引导脚本

在可以正常访问外网的机器上,使用 curl 或 wget 下载对应分支。以 Python 3.6 为例:

# 使用 curl 下载 Python 3.6 对应的 get-pip.py
curl -sS -O https://bootstrap.pypa.io/pip/3.6/get-pip.py

# 或者使用 wget 下载
wget https://bootstrap.pypa.io/pip/3.6/get-pip.py
离线或隔离网闸环境提示: 如果服务器无法直连公网,可以在任意具备网络连接的个人电脑上,通过浏览器打开对应地址将 get-pip.py 保存为文本文件,再通过 scp、sftp 或 U 盘拷贝至目标机器的任意工作目录(例如 /tmp/get-pip.py)。该脚本本身是自包含的独立文件,无需附带其他元数据。

步骤三:使用目标 Python 解释器执行安装

核心规则:始终使用具体解释器去驱动脚本,切勿直接执行 ./get-pip.py,防止调用错误的默认系统环境。

在执行时,推荐带上 --user 参数,将 pip 及相关控制台可执行文件安装在当前用户的家目录下(如 Linux 的 ~/.local 或 Windows 的 %APPDATA%\Python),这能有效避免系统目录写入权限报错,同时防止污染底层 Linux 发行版的系统软件包:

# 方案 A:针对当前用户的安全隔离安装(强烈推荐)
python3.6 get-pip.py --user

# 方案 B:如果确定需要安装至全局环境且具备管理员权限
sudo python3.6 get-pip.py

在控制台中,你将看到类似如下的安装过程输出:

Collecting pip<22.0
  Downloading pip-21.3.1-py3-none-any.whl (1.7 MB)
Collecting setuptools
  Downloading setuptools-59.6.0-py3-none-any.whl (952 kB)
Collecting wheel
  Downloading wheel-0.37.1-py2.py3-none-any.whl (35 kB)
Installing collected packages: wheel, setuptools, pip
Successfully installed pip-21.3.1 setuptools-59.6.0 wheel-0.37.1
关于附加参数的用法: 如果环境极度受限且不需要构建 C 扩展,可追加 --no-setuptools --no-wheel,此时脚本仅会安装 pip 自身,最小化网络与磁盘开销。

步骤四:双向验证安装结果与正确调用姿势

安装完成后,很多人习惯直接在终端输入 pip --version。但在多 Python 版本共存的系统中,裸命令 pip 往往会链接到其他解释器,或者提示 command not found。

最稳妥的标准调用方式,是使用 <目标解释器> -m pip,这能保证 100% 运行与当前解释器绑定的 pip 模块:

# 验证模块是否安装就绪及其版本归属
python3.6 -m pip --version

正确执行后的输出示例:

pip 21.3.1 from /home/developer/.local/lib/python3.6/site-packages/pip (python 3.6)

只要输出末尾明确显示 (python 3.6) 并且输出了对应的版本路径,即证明安装完全成功。

旧版Python或ensurepip失效时,怎么通过get-pip.py手动安装
图 3:get-pip.py 手动安装的标准四步操作流程与执行要点

四、常见安装故障排查与应对方案

在实际执行 python get-pip.py 过程中,由于老旧操作系统的底层库或网络环境受限,可能会出现以下四类典型故障:

1. SSL 证书校验失败(CERTIFICATE_VERIFY_FAILED)

故障表现:在执行过程中抛出 SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed。

根因分析:旧版 Python(尤其是 Python 2.7.9 之前或未打系统补丁的旧 Linux/macOS)内置的根证书颁发机构(CA)列表已严重过期,无法信任现代 PyPI 所使用的 Let's Encrypt 或 DigiCert 现代证书体系;亦或是旧版 OpenSSL 不支持 TLS 1.2。

解决方案:

  • 对于 macOS 用户,进入 Python 安装目录运行官方附带的证书脚本:/Applications/Python\ 3.6/Install\ Certificates.command。
  • 在 Linux 环境下,通过操作系统更新根证书包:sudo apt update && sudo apt install ca-certificates 或 sudo yum update ca-certificates。
  • 应急方案:在安装命令中临时信任 PyPI 官方域名(仅限应急排障,切勿在不安全网络下长期使用):
python get-pip.py --trusted-host pypi.org --trusted-host files.pythonhosted.org

2. 提示没有权限(Permission denied)

故障表现:提示 PermissionError: [Errno 13] Permission denied: '/usr/local/lib/python3.6/site-packages'。

解决方案:不要盲目使用 sudo 强行覆盖全局目录,这可能会破坏系统自身包管理器的依赖树。首选做法是添加 --user 参数将 pip 写入当前登录用户的家目录:

python get-pip.py --user

3. 安装成功后提示 command not found: pip

故障表现:脚本提示 Successfully installed pip,但在命令行输入 pip 时系统报错找不到命令。

根因分析:使用 --user 安装时,pip 的入口脚本被放置在用户目录下的二进制目录中(Linux/macOS 为 ~/.local/bin,Windows 为 %APPDATA%\Python\Python36\Scripts),而该路径尚未加入操作系统的环境变量 PATH 中。

解决方案:

  • 长效方案:将用户二进制目录添加到 Shell 配置文件中(如 ~/.bashrc 或 ~/.zshrc):
    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc
  • 标准方案:无需配置 PATH,始终统一采用 python -m pip <command> 方式调用,这无论在任何操作系统或虚拟环境下均能稳定运行。

4. 依赖缺失或编译环境不全导致 wheel 构建中断

故障表现:在资源受限的小型机器或缺少 gcc、make 的老旧环境中,安装脚本试图连带安装 wheel 或 setuptools 时报错崩溃。

解决方案:使用最小化安装参数,仅提取 pip 本身,跳过 setuptools 与 wheel 的安装:

python get-pip.py --no-setuptools --no-wheel --user
旧版Python或ensurepip失效时,怎么通过get-pip.py手动安装
图 4:旧版 Python 环境下四类典型安装故障的根因诊断与应对方案矩阵

五、安装后的维护与包管理实践

成功通过 get-pip.py 补全 pip 工具后,由于旧版 Python 已经脱离官方技术支持,后续在安装第三方模块时还需遵守以下两项基本维护原则:

  1. 注意第三方模块的历史版本兼容性:现代流行库(如 Requests、NumPy、Pandas 等)的最新版本早已全面放弃对 Python 2.7 或 3.6 的支持。在安装依赖时,请明确锁定旧版本号,例如安装兼容 Python 2.7 的 requests:
    python2.7 -m pip install "requests<2.28.0"
  2. 国内镜像源加速与 HTTPS 证书配置:旧环境的网络握手延时通常较高,可临时或永久指定国内主流镜像源(如清华源或阿里云源)以提高下载成功率:
    python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package_name>
相关专题:

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

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 算法库。