Windows10安装/升级pip后无法使用pip命令问题咨询

核心原因 #

这个报错没有特殊诱因，本质是Windows终端无法在预设的程序搜索路径（PATH环境变量）中找到pip.exe可执行文件，通常是两种情况导致：安装Python时没有勾选自动添加路径到系统的选项，或是升级pip后pip的存储路径发生变化，原路径下找不到对应程序。

分步解决流程 #

• 定位pip的实际存储路径
  pip默认存放在Python安装目录下的Scripts文件夹中，常见路径分两类：
  • 全局安装Python（所有用户可用）时，路径为C:\Program Files\Python3<你的版本号>\Scripts\，比如Python3.10对应路径就是C:\Program Files\Python310\Scripts\
  • 仅给当前用户安装Python、或是加--user参数升级pip时，路径为C:\Users\<你的系统用户名>\AppData\Roaming\Python\Python3<你的版本号>\Scripts\
    如果翻不到对应文件夹，直接打开资源管理器在C盘搜索pip.exe，就能定位到准确的文件夹位置。
• 将pip路径添加到系统PATH
  1. 按Win+S调出系统搜索，输入「环境变量」，打开「编辑系统环境变量」面板
  2. 在弹出的系统属性窗口右下角，点击「环境变量」按钮
  3. 在新弹出的环境变量窗口里，分别选中「用户变量」「系统变量」两个板块下的Path条目，点击「编辑」
  4. 点「新建」，把之前找到的Scripts文件夹完整路径粘贴进去，之后逐一点击所有设置窗口的「确定」保存配置

  注意：必须逐一点确定逐层关闭窗口，直接点右上角叉号不会保存新增的路径配置。

• 验证配置是否生效
  把之前打开的所有CMD、PowerShell窗口全关了（旧终端不会加载新改的环境变量），重新开一个新终端，输入pip --version，如果能正常返回pip版本号、关联的Python路径，就说明问题解决了。

临时替代方案（无需改环境变量） #

如果不想改系统配置，可以直接用Python内置模块调用的方式执行pip命令，格式为py -m pip <原pip后面跟的参数>，比如装requests包就写py -m pip install requests，只要Python本身安装正常，这个命令就能正常用，完全不依赖PATH配置。

常见踩坑提醒 #

如果升级pip的时候加了--user参数，新版pip会被装到当前用户目录下的Scripts文件夹，这时候原来Python安装目录下的Scripts路径里没有新版pip的可执行文件，必须把用户目录下的Scripts路径也加到PATH里，否则还是会报找不到命令的错。

内容的提问来源于stack exchange，提问作者Moaz