pip不是内部或外部命令怎么解决完整指南：理解原因、找到位置、一步步解决

在使用Python进行开发或安装各种库时，pip是一个不可或缺的工具。然而，不少初学者在使用命令行输入pip命令时，会遇到一个令人困惑的错误提示：“’pip’ 不是内部或外部命令，也不是可运行的程序或批处理文件。” 本文将围绕这个问题，深入探讨其背后原因并提供详细的解决方案。

【pip不是内部或外部命令】这个错误是什么意思？

简单来说，当你看到“’pip’ 不是内部或外部命令”这样的提示时，这意味着你当前正在使用的操作系统（比如Windows的命令提示符cmd或PowerShell，或者Linux/macOS的终端）无法找到一个叫做pip的可执行程序来执行你输入的命令。操作系统在接到一个命令后，会去它知道的几个特定位置寻找对应的程序。如果找不到，就会报告这个错误。

你可以把它想象成你想使用一个工具（pip），但你没有告诉你的操作系统（你的助手）这个工具放在哪里，或者操作系统没有被告知去存放这个工具的工具箱里寻找。于是，助手告诉你它找不到这个工具。

为什么会出现【pip不是内部或外部命令】这个错误？

出现这个错误最主要的原因是：pip的可执行文件所在的路径没有被添加到系统的环境变量PATH中。

什么是环境变量PATH？

环境变量PATH是操作系统的一个配置项，它包含了一系列目录路径。当你输入一个命令（比如pip install requests）时，操作系统会按照PATH变量里列出的目录顺序，逐个去查找是否存在一个名为pip的可执行文件。如果找到，就执行它；如果找遍了所有目录都没找到，就会报“不是内部或外部命令”的错误。

Python安装完成后，通常会将pip（以及其他一些脚本）放在Python安装目录下的一个名为Scripts（Windows）或bin（Linux/macOS）的子目录里。如果这个Scripts或bin目录的路径没有被添加到系统的PATH环境变量中，那么你在任何其他目录下打开命令行窗口输入pip时，系统就不知道去哪里找到它，从而导致错误。

其他可能的原因（较少见）：

Python安装不完整或损坏，导致pip没有被正确安装。
安装Python时，没有勾选“Add Python to PATH”的选项（在Windows安装程序中）。
安装了多个Python版本，而你当前调用的Python版本没有pip，或者pip属于另一个未添加到PATH的版本。
在某些情况下，可能是由于系统权限问题导致无法访问pip可执行文件，但这通常会有不同的错误提示。

大多数情况下，问题都出在环境变量PATH上。

如何解决【pip不是内部或外部命令】的问题？

解决这个问题的核心就是确保系统能够找到pip的可执行文件。最常用和推荐的方法是将Python安装目录下的Scripts（或bin）目录添加到系统的PATH环境变量中。

方法一：将Python Scripts（或bin）目录添加到系统的PATH环境变量（推荐）

这个方法一劳永逸，添加后你就可以在任何位置使用pip命令了。操作步骤因操作系统而异：

在 Windows 上添加 PATH

这是Windows用户最常见的情况。请按照以下步骤操作：

找到 Python 的 Scripts 目录路径：
- 首先，你需要知道你的Python安装在哪里。通常安装在 C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX 或 C:\PythonXX （XX代表版本号，如39、310等）。
- 在这个Python安装目录下，找到一个名为 Scripts 的文件夹。例如，如果你的Python安装在 C:\Python310，那么Scripts目录就是 C:\Python310\Scripts。
- 如果你不确定Python安装在哪里，可以尝试打开命令提示符，输入 where python 或 py -0p （如果安装了py启动器）来查找Python可执行文件的位置，然后向上回溯找到主安装目录，再找Scripts文件夹。或者，你也可以在安装Python时记住安装路径。
打开系统环境变量设置：
- 在Windows搜索栏输入“环境变量”，然后点击“编辑系统环境变量”。
- 会打开“系统属性”窗口，点击右下角的“环境变量(N)…”按钮。
编辑 PATH 变量：
- 在“系统环境变量”列表中，找到一个名为 Path (或 PATH) 的变量，选中它。
- 点击“编辑(I)…”按钮。
添加 Scripts 目录路径：
- 在“编辑环境变量”窗口中，点击“新建(N)”。
- 将你在步骤1中找到的Python Scripts目录的完整路径粘贴进去。例如：C:\Python310\Scripts。
- 通常，为了方便调用Python本身，你还需要将Python的主安装目录也添加到PATH中（Python可执行文件 python.exe 就在这里）。例如：C:\Python310。
  
  注意：请确保添加的是你当前希望使用的Python版本的路径。如果你安装了多个Python版本，可能需要根据你的需求添加或调整它们的顺序。在较新版本的Windows中，列表的顺序决定了查找的优先级。
保存并关闭窗口：
- 点击所有打开的环境变量和系统属性窗口中的“确定”按钮，保存你的更改。
验证更改：
- 非常重要：关闭你当前打开的命令提示符或PowerShell窗口，然后重新打开一个新的命令行窗口。环境变量的更改通常只在新打开的窗口中生效。
- 在新打开的命令行窗口中，输入 pip --version。如果一切正常，你应该能看到pip的版本信息，而不是错误提示。
- 你也可以输入 pip install requests 这样的命令来测试是否能正常运行。

在 macOS 和 Linux 上添加 PATH

在macOS或Linux上，修改PATH通常是通过编辑你的shell配置文件来完成的（如 ~/.bashrc, ~/.zshrc, ~/.profile 等）。

找到 Python 的 bin 目录路径：
- 使用命令 which python 来查找当前默认Python解释器的位置。
- Python的可执行文件（python）通常在 /usr/local/bin/python 或 ~/opt/anaconda3/bin/python 等位置。pip的可执行文件（pip）通常和python在同一个目录下，或者是一个指向该目录的链接。
- 确认包含pip可执行文件的目录路径。
编辑 shell 配置文件：
- 打开终端。
- 使用文本编辑器（如 nano, vim, VS Code等）打开你的shell配置文件。例如，如果你使用zsh（macOS Catalina及更新版本默认），打开 ~/.zshrc：
  nano ~/.zshrc
- 如果你使用bash，可能需要编辑 ~/.bashrc 或 ~/.profile：
  nano ~/.bashrc
添加或修改 PATH 变量：
- 在文件的末尾，添加或修改一行来导出（export）你的PATH变量。如果已经有PATH的设置，确保包含你的Python bin目录。如果不存在，添加类似下面的一行（请将 /path/to/your/python/bin 替换为你实际找到的路径）：
  export PATH="/path/to/your/python/bin:$PATH"
  这行代码的含义是：将你的Python bin目录路径放在现有的PATH前面，并将其设置为新的PATH。
- 保存并关闭文件。
使更改生效：
- 在终端中，运行以下命令来重新加载配置文件：
  如果你编辑了 .zshrc：source ~/.zshrc
  如果你编辑了 .bashrc：source ~/.bashrc
- 或者，最简单的方式是关闭当前终端窗口，然后重新打开一个新的终端窗口。
验证更改：
- 在新打开的终端中，输入 pip --version。如果成功，将显示pip的版本信息。

方法二：使用 python -m pip 命令（无需修改PATH，推荐作为替代方案）

这是另一个非常推荐的方法，因为它不依赖于系统的PATH设置，而是直接通过Python解释器来调用pip模块。这个方法的好处是，如果你安装了多个Python版本，你可以明确指定使用哪个Python的pip。

语法是：python -m pip <pip命令>

例如：

安装一个库：python -m pip install requests
查看pip版本：python -m pip --version
升级pip本身：python -m pip install --upgrade pip

这个方法之所以有效，是因为你不是直接让操作系统去PATH里找一个叫做pip的程序，而是告诉它运行python这个程序，并且让python去执行它内部的pip模块。只要你的python命令是可用的（通常Python安装程序会确保这一点，或者你将Python主目录添加到了PATH），这个方法就能工作。

如果你不确定哪个python命令对应你想要的Python版本，可以尝试使用特定版本的命令，例如：

python3 -m pip install package
python3.9 -m pip install package
py -3.10 -m pip install package (Windows下使用py启动器)

使用 python -m pip 是一个非常健壮且推荐的运行pip的方式，尤其是在多Python环境或不便修改系统PATH的情况下。

方法三：检查Python安装或重新安装Python

如果在完成方法一和方法二后，问题依然存在，或者你确定Python安装本身可能有问题，可以考虑以下步骤：

检查 Python 是否能正常运行： 在命令行输入 python --version 或 python3 --version。如果这个命令也报错“不是内部或外部命令”，那么问题比pip更基础，是Python本身没有添加到PATH，或者Python根本就没有正确安装。
在 Python 安装目录查找 Scripts 文件夹： 手动导航到你的Python安装目录，看看Scripts（或bin）文件夹是否存在，以及里面是否有 pip, pip3, pip3.x 等可执行文件（在Windows上是 .exe 文件）。如果这个文件夹或文件缺失，说明安装可能损坏。
重新运行 Python 安装程序：
- 下载对应版本的Python安装程序。
- 运行安装程序。
- 重要： 在Windows安装过程中，务必勾选“Add Python to PATH”选项。选择“Customize installation”可以更详细地检查是否选择了安装pip（通常是默认勾选的）。
- 如果选择覆盖安装或修复安装，可能会解决问题。

方法四：确认pip是否已随Python安装

自Python 3.4版本起，pip已经包含在Python的标准安装包中。除非你使用了非常老旧的Python版本，或者在安装时明确去掉了pip的勾选，否则pip应该是默认安装的。

你可以通过 python -m ensurepip 命令来尝试安装或升级pip。如果在运行 python -m ensurepip 后再尝试使用 python -m pip，可能会解决问题。

我应该在哪里找到pip的可执行文件？

如前所述，pip的可执行文件通常位于你的Python安装目录下的一个特定子文件夹中：

在 Windows 上： <你的Python安装路径>\Scripts 例如：C:\Python310\Scripts
在 macOS 或 Linux 上： <你的Python安装路径>/bin 例如：/usr/local/bin 或 ~/opt/anaconda3/bin

在你尝试将该路径添加到PATH环境变量时，就是需要找到这个确切的文件夹路径。

如果安装了多个Python版本，如何处理？

如果你安装了Python 2和Python 3，或者安装了不同版本的Python 3 (如 3.9 和 3.10)，或者同时使用了官方Python和Anaconda等发行版，那么“pip不是内部或外部命令”的问题可能变得稍微复杂，或者你遇到的问题是调用了错误版本的pip。

在这种情况下：

优先使用 python -m pip： 这是处理多版本最可靠的方法。你可以明确指定使用哪个Python来运行pip。例如，使用 Python 3.10 的 pip，你可能需要运行 python3.10 -m pip install package。
检查 PATH 变量中的顺序： 如果你确实想通过直接输入 pip 命令来调用，那么在修改PATH环境变量时，请注意将你希望默认使用的Python版本的Scripts（或bin）目录放在列表中的靠前位置。系统会按照列表顺序查找并执行第一个找到的pip。
使用特定版本的pip命令： 有时安装程序会创建特定版本的pip命令，例如 pip3, pip3.9 等。你可以尝试直接使用这些命令来调用特定版本的pip，例如 pip3 install package。
使用虚拟环境 (Virtual Environments)： 对于更复杂的项目管理，强烈推荐使用虚拟环境（venv 或 conda）。虚拟环境会为每个项目创建一个独立的Python安装目录和Scripts/bin目录，并且激活虚拟环境后，系统会自动使用该环境的Python和pip，避免了不同项目或全局环境之间的冲突。激活虚拟环境后，直接使用 pip 命令即可。

总结

“’pip’ 不是内部或外部命令”是一个常见的环境变量配置问题，尤其是在Windows系统上。解决它的主要方法是将Python安装目录下的Scripts（或bin）文件夹路径正确地添加到系统的PATH环境变量中。作为一种更灵活和推荐的替代方案，特别是对于多Python环境，使用 python -m pip <命令> 的方式来调用pip可以有效避免这类问题。

按照本文提供的详细步骤，检查并配置你的系统环境变量，或者采用 python -m pip 的方式，通常都能彻底解决这个困扰你的问题，让你顺利地使用pip安装和管理Python库。