[已解决] ModuleNotFoundError: No module named ‘pip‘

写在前面

在使用 Python 环境时，ModuleNotFoundError: No module named 'pip' 是常见的错误，特别是在初次配置 Python 或重新安装 Python 后出现。此错误意味着系统未能找到 pip 模块，可能由于环境变量配置问题、pip 未正确安装或 Python 安装不完整等原因。

问题描述

报错代码行：

ModuleNotFoundError: No module named 'pip'

报错原因分析

1. pip 未安装：在某些情况下，Python 安装过程中未附带 pip，导致无法使用 pip 命令。
2. 环境变量配置错误：即使 pip 已安装，但系统未正确配置 Python 或 pip 的路径，导致系统无法识别 pip。
3. Python 安装不完整或损坏：如果 Python 安装包不完整，可能导致 pip 相关文件缺失。
4. 多个 Python 版本共存：系统中存在多个 Python 版本时，可能会导致 pip 和 python 版本不匹配，找不到对应的 pip 模块。
5. 虚拟环境中缺少 pip：在创建虚拟环境时，pip 可能未自动安装，导致在虚拟环境中使用 pip 时出现错误。

解决思路

1. 检查 Python 安装路径：确认系统是否正确安装了 Python，并检查是否包含 pip。
2. 手动安装或升级 pip：通过 Python 自带的脚本手动安装或升级 pip。
3. 检查并配置环境变量：确保 python 和 pip 的路径已经添加到系统环境变量中。
4. 重新安装 Python：如果 Python 安装包不完整，建议重新安装，确保安装过程中选中 Add Python to PATH 选项。
5. 在虚拟环境中安装 pip：若在虚拟环境中使用 pip，则需要单独安装。

解决办法

1. 手动安装或升级 pip

如果 Python 已正确安装，可以通过 ensurepip 模块来安装 pip：

python -m ensurepip --upgrade

此命令会自动安装或升级 Python 中的 pip。

2. 使用 get-pip.py 脚本

如果 ensurepip 无法解决问题，可以从官方获取 get-pip.py 文件，并手动安装 pip：

1. 下载 get-pip.py：

   • 打开浏览器，访问 get-pip.py 官方链接。
   • 将文件下载到本地（如 C:\get-pip.py）。

2. 运行以下命令安装 pip：

   python C:\get-pip.py
   

   这将自动下载并安装 pip。

3. 检查环境变量配置

确保 python 和 pip 的路径已添加到系统的环境变量中：

1. Windows:

   • 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
   • 在“系统变量”中找到 Path，并添加 Python 和 pip 的安装路径（如 C:\Python39\Scripts\ 和 C:\Python39\）。

2. macOS/Linux:

   • 编辑 ~/.bashrc 或 ~/.zshrc 文件，添加 Python 路径：

     export PATH="$PATH:/usr/local/bin/python3"
     

   • 保存并运行：

     source ~/.bashrc
     

4. 重新安装 Python 并确保添加到 PATH

如果问题依然存在，可以尝试重新安装 Python，并确保在安装过程中选择了“Add Python to PATH”选项：

1. 下载最新版 Python 安装程序：Python 官方下载
2. 运行安装程序，并勾选“Add Python to PATH”选项。
3. 安装完成后，检查 Python 和 pip 是否正常：

   python --version
   pip --version
   

5. 在虚拟环境中安装 pip

如果是在虚拟环境中遇到此错误，可以在虚拟环境中手动安装 pip：

python -m ensurepip

或者在虚拟环境中运行：

python -m pip install --upgrade pip

6. 使用 conda 安装 pip（如果使用 Anaconda）

如果使用的是 Anaconda 管理 Python 环境，可以通过 conda 安装 pip：

conda install pip

确保 pip 已成功安装在对应的 Anaconda 环境中。

总结

ModuleNotFoundError: No module named 'pip' 错误通常是由于 pip 模块未安装或路径配置错误引起的。通过手动安装 pip、调整环境变量、检查 Python 安装完整性等方式可以有效解决问题。在使用虚拟环境时，确保在虚拟环境内也有 pip 的正确配置。通过上述方法可以快速解决 pip 模块找不到的问题。