Windows系统下Python pip的安装步骤与环境变量配置

清欢
清欢
发布时间:2026-10-10 | 2人浏览过
原创

在Windows系统中使用Python时,pip是安装与管理第三方库(如requests、numpy等)的核心工具。很多初学者在命令行中输入pip时,常会遇到提示“'pip' 不是内部或外部命令,也不是可运行的程序或批处理文件”。本文将完整讲解如何在Windows环境下检查已有状态、通过标准方式安装或修复pip,以及正确配置系统Path环境变量,确保命令行随时可以调用pip。

一、检查系统当前是否已存在pip

现代版本的标准Python安装包在默认情况下已经集成了pip模块。在着手下载安装文件之前,应先确认系统中是否其实已经具备pip,只是缺少外部调用入口。

按快捷键 Win + R 打开“运行”窗口,输入 cmd 并回车,启动命令提示符。在打开的窗口中分别执行以下两个命令进行探测:

执行命令:直接检测pip版本
pip --version
示例输出(若已配置成功):
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip (python 3.11)

如果系统提示未找到命令,不要急于重新下载安装包,可以继续通过Python解释器本身调用其内置的pip模块测试:

执行命令:通过Python模块运行pip
python -m pip --version
示例输出:
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip (python 3.11)

如果 python -m pip --version 能够正常显示版本号,说明pip本身已经被放置在本地磁盘中,仅仅是因为存放pip可执行程序的目录尚未加入系统的环境变量 Path,直接跳转到本文第三节进行环境变量配置即可;如果该命令提示未找到Python或没有该模块,则需要按照下文步骤进行安装。

Windows系统下Python pip的安装步骤与环境变量配置
图1:Windows系统下检测与定位pip现状的判断流程

二、安装与修复pip的两种标准方法

如果通过上一步确认系统中确实未集成或丢失了pip文件,可选择以下两种官方推荐的方法进行安装或恢复。

方法一:利用内置的 ensurepip 模块安装(离线优先)

Python 3.4及以上版本内置了 ensurepip 模块,它能够在无需联网下载外部脚本的情况下,直接将当前Python安装包中附带的pip组件自举解压到标准运行目录。

在命令提示符中执行以下命令:

执行命令:使用ensurepip安装或升级pip
python -m ensurepip --default-pip
示例输出:
Looking in links: c:\Users\Username\AppData\Local\Temp\tmp...
Processing c:\users\username\appdata\local\temp\tmp...\pip-24.0-py3-none-any.whl
Installing collected packages: pip
Successfully installed pip-24.0

该命令执行完成后,pip相关程序文件便会写入到Python主目录之下的 Scripts 文件夹中。

方法二:通过官方 get-pip.py 脚本安装(联网获取最新版)

如果系统提示 ensurepip 模块也被精简删除,或者需要直接获取当前官方最新版本的pip,可以使用官方引导脚本进行全新安装:

  1. 打开浏览器访问官方引导脚本链接 https://bootstrap.pypa.io/get-pip.py,或者在命令行中使用curl工具直接下载:
执行命令:下载get-pip.py引导脚本
curl -O https://bootstrap.pypa.io/get-pip.py
  1. 在下载了 get-pip.py 的目录中打开命令提示符,执行该脚本:
执行命令:运行引导脚本安装pip
python get-pip.py
示例输出:
Collecting pip
  Downloading pip-24.0-py3-none-any.whl (2.1 MB)
Installing collected packages: pip
Successfully installed pip-24.0
Windows系统下Python pip的安装步骤与环境变量配置
图2:从确认缺失到成功运行的四个关键环节

三、配置Windows环境变量Path

安装完成后,pip.exe 文件被放置在Python根目录下的 Scripts 文件夹中。Windows系统只有在 Path 环境变量中找到了该文件夹的绝对路径,才能在任意终端目录下识别并执行 pip 命令。

第一步:获取准确的Scripts目录绝对路径

如果不清楚当前Python具体的安装目录,无需在资源管理器中逐层搜索,可以在命令提示符中执行以下Python语句直接打印:

执行命令:查询Python主目录与Scripts目录
python -c "import sys, pathlib; p=pathlib.Path(sys.executable).parent; print('Python目录:', p); print('Scripts目录:', p / 'Scripts')"
示例输出:
Python目录: C:\Users\Username\AppData\Local\Programs\Python\Python311
Scripts目录: C:\Users\Username\AppData\Local\Programs\Python\Python311\Scripts

复制上述输出中 Scripts目录 对应的完整路径(例如 C:\Users\Username\AppData\Local\Programs\Python\Python311\Scripts)。

第二步:将路径添加至系统Path中

  1. 按快捷键 Win + R 打开运行对话框,输入 sysdm.cpl 并回车,直接打开“系统属性”窗口。
  2. 在弹出的对话框中切换至“高级”选项卡,点击底部的“环境变量(N)...”按钮。
  3. 在“用户变量”或“系统变量”区域中找到名为 Path 的条目(若只想对当前用户生效可选择用户变量,若需多账户共用可选择系统变量),选中后点击“编辑(E)...”。
  4. 在编辑界面右侧点击“新建(N)”,将刚才复制的 Scripts 完整目录路径粘贴进去。
  5. 为了保证Python运行环境的健全,建议同时确认Python根目录(即包含 python.exe 的目录)也在该列表中。若没有,一并点击新建并粘贴根目录。
  6. 连续点击“确定”关闭所有设置窗口,完成配置保存。
Windows系统下Python pip的安装步骤与环境变量配置
图3:系统Path与Python根目录及Scripts目录的映射关系
重要提醒:修改环境变量后,必须关闭原有的命令提示符窗口并重新打开。已开启的cmd或PowerShell窗口只会保留打开瞬间的环境变量快照,不会自动加载最新的Path改动。

四、验证配置结果与日常维护操作

重新打开一个新的命令提示符窗口,通过实际命令验证pip是否已经具备全局调用的能力。

1. 验证全局命令调用

执行命令:验证pip及所在路径
where pip
pip --version
示例输出:
C:\Users\Username\AppData\Local\Programs\Python\Python311\Scripts\pip.exe
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip (python 3.11)

如果 where pip 能够精准列出刚才配置的 Scripts 路径,且 pip --version 正常输出了版本号,说明环境变量配置已完全生效。

2. 常用基础维护命令

在日常使用中,pip本身的更新及国内镜像源配置是最常见的两项操作:

升级 pip 自身至最新版本:
python -m pip install --upgrade pip
配置国内镜像源(解决下载缓慢或超时报错):
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Windows系统下Python pip的安装步骤与环境变量配置
图4:Windows环境下使用pip时的典型问题定位与排查方案

五、总结

在Windows系统下规范使用pip的核心在于明确其位置与运行机制:

  • 组件所在:pip.exe 存放在Python根目录下的 Scripts 文件夹中。
  • 安装原则:优先使用Python自带的 ensurepip 模块进行自举安装;精简环境下使用官方提供的 get-pip.py 脚本直接安装。
  • 环境关键:将具体的 Scripts 目录完整路径添加到系统 Path 变量,并重启命令行窗口完成环境刷新。

完成以上步骤后,即可直接在任意路径下使用标准的 pip install 包名 指令安装所需的Python依赖包。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表