Windows下Python安装后没有pip的修复方法
pip 收到“'pip' 不是内部或外部命令,也不是可运行的程序”提示,通常只有两类根本原因:一是 pip 已经随 Python 一同安装,但存放可执行程序的 Scripts 目录未加入系统环境变量 PATH;二是安装 Python 时取消了 pip 勾选,或下载了不包含标准库工具的 Windows 嵌入式(embeddable)免安装版。本文将详细说明如何快速诊断具体症结,并通过内置命令、安装包维护、官方脚本及环境变量配置彻底解决该问题。
一、现象自查:判断 pip 是“未安装”还是“未配置路径”
排查问题的第一步,是确认当前 Python 环境内部到底有没有 pip 模块。很多用户在命令行执行 pip 失败后便急于重新下载整个安装包,其实 pip 本身往往已经存在于硬盘中。
请按下键盘上的 Win + R 键,输入 cmd 并回车打开命令提示符,输入以下诊断命令:
python -m pip --version
pip 24.0 from C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)。结论:Python 环境中已经安装了 pip,无法直接输入
pip 只是因为系统找不到 pip.exe 的存放路径。读者可直接跳转到第五节配置环境变量。情况 B(报错 No module named pip):输出
No module named pip。结论:当前 Python 环境中确实缺失 pip 模块本身,需要采用第二节至第四节中的方法补齐该模块。
二、修复方法一:使用内置 ensurepip 模块一键恢复
在官方标准的 Windows Python 安装目录中,其实已经随包打包了离线的 ensurepip 修复机制。只要安装的不是被大幅阉割的第三方版本,该模块可以在没有互联网连接的情况下,将基础版本的 pip 和 setuptools 释放并安装到当前环境中。
1. 执行恢复命令
打开命令提示符(如果 Python 安装在 C:\Program Files 等系统受保护目录下,建议右键选择“以管理员身份运行”CMD),执行:
python -m ensurepip --default-pip
Looking in links: c:\temp\...\
Processing c:\users\...\wheel\setuptools-xx.x.x-py3-none-any.whl
Processing c:\users\...\wheel\pip-xx.x.x-py3-none-any.whl
Installing collected packages: setuptools, pip
Successfully installed pip-xx.x.x setuptools-xx.x.x
2. 将 pip 升级到最新版本
ensurepip 释放出的 pip 版本往往与当初 Python 编译时的版本一致,通常落后于当前 PyPI 官方最新版本。安装完成后,建议紧接着执行升级命令:
python -m pip install --upgrade pip
python -m pip ... 这种调用方式与直接在命令行输入 pip ... 效果完全等价,而且能在系统中存在多个 Python 版本时,精准指定具体调用哪个 Python 的环境。
三、修复方法二:运行 Python 官方安装包执行 Modify(修改)
如果当初是通过 Python 官网下载的 .exe 安装程序(如 python-3.12.x-amd64.exe)安装的,最稳妥且图形化的修复方式是重新调出安装向导,勾选漏掉的组件。
- 找到安装程序或从系统设置打开:在下载文件夹中双击之前下载的 Python 安装程序;如果安装程序已删除,也可以打开 Windows“设置” -> “应用” -> “安装的应用”(或控制面板的“卸载程序”),在列表中找到 Python,点击右侧的三个点并选择“修改”。
- 选择 Modify(修改):安装向导弹出后,会看到三个选项:Modify(修改)、Repair(修复)、Uninstall(卸载)。直接点击第一项【Modify】。
- 勾选 pip 选项:进入“Optional Features”(可选功能)界面,这里列出了文档、pip、tcl/tk 以及 Python test suite 等选项。请务必确认勾选【pip】复选框,随后点击【Next】。
- 勾选环境变量选项并确认安装:在接下来的“Advanced Options”(高级选项)界面中,建议同时勾选【Add Python to environment variables】(将 Python 添加到环境变量),然后点击【Install】。
-
等待修改完成:安装程序会自动向系统补充写入
Scripts/pip.exe、pip3.exe以及相关依赖库。完成后点击【Close】。
四、修复方法三:使用官方 get-pip.py 引导脚本手动安装
当内置的 ensurepip 模块由于文件缺失报错(例如某些精简优化版系统移除了内置 wheel 文件),或者使用的是解压即用的嵌入式 Python(Windows embeddable package)时,最直接可靠的方式就是使用 Python 官方提供的 get-pip.py 脚本。
1. 获取 get-pip.py 脚本
在 Windows 10/11 的 PowerShell 或 CMD 中,系统自带了 curl 工具,可以直接执行以下命令将官方脚本下载到本地当前目录:
curl -sS https://bootstrap.pypa.io/get-pip.py -o get-pip.py
如果命令行无法下载,也可以在浏览器中直接访问 https://bootstrap.pypa.io/get-pip.py,在页面中按下 Ctrl + S,将网页另存为名为 get-pip.py 的文件。
2. 运行脚本安装 pip
切换到保存了 get-pip.py 的目录下,运行以下命令:
python get-pip.py
如果你下载的是形如
python-3.12.x-embed-amd64.zip 的免安装包,解压后默认配置会忽略当前目录下的第三方库。运行 get-pip.py 之前,必须在 Python 根目录下找到 python312._pth 文件(根据主版本不同文件名有差异),用记事本打开它,将末尾被注释掉的 #import site 前面的 # 删掉,保存为 import site,然后再执行 python get-pip.py,否则 pip 就算安装成功也无法正常加载。
五、修复方法四:补齐系统 PATH 环境变量
很多时候,用户完成了上面的安装,或者本身 python -m pip --version 就完全正常,但在命令行输入 pip 依旧提示找不到命令。这是因为在 Windows 机制中,可执行文件是依赖环境变量 PATH 进行全局索引的。
Python 安装后会有两个关键目录:一个是 python.exe 所在的根目录;另一个是存放第三方命令工具(如 pip.exe、pytest.exe、wheel.exe)的 Scripts 目录。两者必须都配置在 PATH 中。
1. 快速确认自己的 Python 安装路径
如果你不清楚自己的 Python 安装在哪个具体路径,可以在命令提示符输入这行命令自动打印:
python -c "import sys; print(sys.prefix)"
输出示例:C:\Users\Administrator\AppData\Local\Programs\Python\Python312。
那么需要添加的两个路径分别是:
- 主程序路径:
C:\Users\Administrator\AppData\Local\Programs\Python\Python312 - Scripts 路径:
C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Scripts
2. 在 Windows 中添加环境变量的具体步骤
- 按下快捷键
Win + R,在“运行”窗口中输入sysdm.cpl并回车,直接打开系统的“系统属性”对话框。 - 切换到顶部的【高级】选项卡,点击右下角的【环境变量(N)...】按钮。
- 在“用户变量”或“系统变量”区域中,找到名为
Path的变量,选中它并点击【编辑(I)...】。 - 在弹出的编辑界面中点击右侧的【新建(N)】,分别将上面得到的“主程序路径”和“Scripts 路径”粘贴进去。
- 点击【确定】保存每一层窗口。
六、结果验证与常见问题避坑指南
完成上述步骤后,重新打开一个全新的命令行窗口,执行以下命令验证修复成果:
pip --version
pip 24.0 from C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)
如果能正常显示类似上述版本和路径信息,说明 pip 已经完全恢复正常。
常见排查要点与避坑策略
-
被 Windows 微软商店快捷方式劫持:
在 Windows 10/11 中,有时输入python或pip会自动弹出应用商店。这是 Windows 自带的“应用执行别名”所致。可以在 Windows 设置中搜索“应用执行别名”(Manage app execution aliases),将其中关于“Python”的别名开关全部关闭。 -
安装了多个 Python 版本导致的 pip 错位:
如果电脑中同时装有 Python 3.10 和 3.12,直接输入pip可能会指向另一个版本的 Scripts。对于多环境场景,推荐使用 Windows 官方启动器py来明确调用:py -3.12 -m pip install requests -
权限受限导致安装包写入失败:
如果 Python 安装在C:\Program Files下,后续使用pip install安装库可能会遇到PermissionError。解决办法是以管理员身份运行 CMD,或者在安装时添加--user参数(例如pip install --user <package-name>)。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









