Python 3.9安装时pip未自动安装的补救方法
在安装 Python 3.9 之后,如果在命令行输入 pip 却收到“不是内部或外部命令”或“command not found”的提示,通常意味着两种情况:一是安装时取消勾选了 pip 组件或使用了精简压缩包,导致 pip 实体文件根本未写入硬盘;二是 pip 已经写入硬盘,但其所在的 Scripts 目录没有加入系统环境变量。解决此问题无需卸载重装,通过 Python 3.9 自带的 ensurepip 模块、官方 get-pip.py 引导脚本或安装包自带的修改功能即可恢复。
一、先区分是“没有装上”还是“找不到路径”
在采取补救措施前,需要先执行两条测试命令。请打开命令提示符(Windows 上的 CMD 或 PowerShell,macOS/Linux 上的 Terminal),输入以下命令:
python -V
python -m pip -V
这两条命令的返回结果决定了后续应采取的具体步骤:
- 如果
python -V返回Python 3.9.x,但python -m pip -V报错No module named pip:这表明 Python 3.9 正常运行,但安装目录中确实没有 pip 模块,必须执行补装操作(请看后文的方法一或方法二)。 - 如果
python -m pip -V能够正确打印出版本号(例如pip 20.x.x ...):这说明 pip 实际上已经安装在系统中,只是它的可执行脚本目录未被写入系统的PATH环境变量,导致系统无法在全局识别pip指令(请直接看第四节的环境变量修复)。
二、补救方法一:使用 Python 3.9 内置的 ensurepip 模块(推荐)
官方发布的 Python 3.9 安装包通常自带一个名为 ensurepip 的标准库模块。它的作用就是在没有联网或 pip 损坏的环境下,将 Python 自带的 pip 离线包解包并写入到当前的 Python 环境中。
在终端中直接运行以下命令:
python -m ensurepip --default-pip
命令参数说明:--default-pip 参数指示系统在安装 pip 模块的同时,在 Python 根目录的 Scripts(Windows)或 bin(Linux/macOS)目录下生成名为 pip、pip3 和 pip3.9 的可执行脚本程序。
正常执行后,终端会输出类似以下的安装记录:
Looking in links: C:\Users\ADMINI~1\AppData\Local\Temp\...
Processing c:\...\setuptools-49.2.1-py3-none-any.whl
Processing c:\...\pip-20.2.3-py2.py3-none-any.whl
Installing collected packages: setuptools, pip
Successfully installed pip-20.2.3 setuptools-49.2.1
C:\Program Files 等需要管理员权限的系统目录,上述命令可能会报 PermissionError。此时需要鼠标右键点击“命令提示符”,选择“以管理员身份运行”后再执行该命令。Linux/macOS 环境下需在命令前添加 sudo。
三、补救方法二:使用官方 get-pip.py 脚本网络安装
如果在执行 ensurepip 时提示 No module named ensurepip(常见于某些 Linux 发行版经精简打包的 Python,或者 Windows 便携精简版),内置模块无法使用,则需要借助 Python 官方提供的在线安装脚本 get-pip.py。
操作步骤如下:
- 下载官方脚本:使用浏览器打开并另存
https://bootstrap.pypa.io/get-pip.py;或者在终端中通过curl命令直接下载到当前目录:curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py - 运行安装脚本:在保存该文件的目录下,使用 Python 3.9 解释器执行该脚本:
python get-pip.py
该脚本会自动连接 PyPI 官方镜像库,解析并安装与当前 Python 3.9 兼容的 pip 版本及其运行环境依赖(包括 wheel 和 setuptools)。
四、补齐环境变量:解决系统找不到 pip 命令的问题
很多情况下,pip 已经成功写入到了计算机中,但终端依然无法执行 pip 命令。这是因为操作系统的可执行文件搜索机制没有覆盖到 pip 所在的实际路径。
在 Windows 环境下,Python 3.9 的主程序 python.exe 通常安装在形如 C:\Python39 或 C:\Users\<用户名>\AppData\Local\Programs\Python\Python39 的目录下。但 pip 可执行文件存放在该目录下的 Scripts 子文件夹中。
配置 Windows 系统环境变量的具体步骤:
- 使用快捷键
Win + R唤出运行窗口,输入sysdm.cpl并回车,打开“系统属性”对话框。 - 切换至“高级”选项卡,点击底部的“环境变量”按钮。
- 在“系统变量”或“用户变量”区域中找到名为
Path的变量,选中后点击“编辑”。 - 点击“新建”,分别添加两行路径(以默认用户路径为例,请根据实际安装位置替换用户名):
C:\Users\<用户名>\AppData\Local\Programs\Python\Python39 C:\Users\<用户名>\AppData\Local\Programs\Python\Python39\Scripts - 依次点击“确定”保存所有弹窗。注意:修改环境变量后,必须关闭所有现有的命令提示符或 PowerShell 窗口并重新打开,新的环境变量才会生效。
五、针对 Windows 官方安装包的图形界面修复
如果最初是通过 Python 官方的 python-3.9.x-amd64.exe 安装程序进行部署的,可以重新利用该安装包进行功能追加:
- 双击运行当初使用的 Python 3.9 安装文件。
- 安装程序会检测到当前系统已存在 Python 3.9,并弹出三个维护选项:Modify(修改)、Repair(修复)、Uninstall(卸载)。
- 选择 Modify 进入可选特性列表,务必确认勾选 pip 和 py launcher 选项。
- 点击 Next,在高级选项界面勾选 Add Python to environment variables,随后点击 Install 完成组件追加。
六、操作验证与更新
完成上述补救步骤后,打开全新的命令行窗口,执行以下验证指令:
pip --version
终端若能正常打印出版本信息及对应路径,表明补救成功:
pip 20.2.3 from c:\users\...\python\python39\lib\site-packages\pip (python 3.9)
由于通过 ensurepip 恢复的通常是 Python 3.9 发布时绑定的旧版 pip(通常为 20.x 版本),建议最后执行一次常规更新命令,将 pip 提升至兼容 3.9 的最新稳定版本:
python -m pip install --upgrade pip
升级完成后,即可正常使用 pip install <package> 进行日常依赖库的安装与管理。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













