Python系列Bug修复PyCharm控制台pip install报错：如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘requests’ 问题

摘要

在 Python 开发 中，requests 是最常用的 HTTP 请求库之一，几乎每个 Web 爬虫、API 调用、数据接口项目都会依赖它。然而，即使已经使用 pip install requests 安装，运行程序时依然可能报错：

ModuleNotFoundError: No module named 'requests'

这种情况往往发生在 环境配置不当、依赖冲突、pip安装路径错误 等场景下。本文将从开发环境、常见错误、完整排查流程和最佳实践等角度，给出详细解决方案。

---

一、开发环境说明

• 操作系统：macOS
• Python版本：Python 3.12
• IDE：PyCharm 2025 专业版
• 使用场景：API请求、Web爬虫

---

二、常见问题与解决方案

2.1 模块未正确安装

有时安装过程并没有真正执行到当前环境：

pip install requests

如果你在 PyCharm 中使用虚拟环境，需要确保 Interpreter 与安装命令对应：

which python
python -m pip install requests

---

2.2 网络问题导致安装失败

若 pip install 下载慢、报错，建议切换国内源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

表格总结常用国内源：

镜像源	配置地址
清华	https://pypi.tuna.tsinghua.edu.cn/simple
阿里	https://mirrors.aliyun.com/pypi/simple
豆瓣	https://pypi.doubanio.com/simple

---

2.3 忘记 import

安装后如果忘记 import requests，程序依然报错：

import requests

---

2.4 路径不在 PYTHONPATH

可能安装路径与运行路径不一致：

import sys
print(sys.path)

确保 site-packages 路径存在。必要时在 PyCharm 中设置 Project Interpreter -> Paths。

---

2.5 pip 版本过旧

更新 pip 避免依赖无法解析：

python -m pip install --upgrade pip setuptools wheel

---

2.6 自建模块冲突

如果项目中自己新建了 requests.py 文件，会覆盖官方库。
✅ 解决办法：重命名文件。

---

2.7 版本冲突

在某些情况下需要指定版本：

pip install requests==2.31.0

---

---

三、完整排查流程图

---

四、扩展解决方案清单

• ✅ 使用 conda 安装：conda install requests

• ✅ 强制重装：pip install --force-reinstall requests

• ✅ 使用 --user 安装到用户目录：

  pip install --user requests
  

• ✅ 检查虚拟环境是否激活：

  source venv/bin/activate
  

• ✅ 在 requirements.txt 中固定版本，避免冲突

---

五、总结对照表

问题场景	对应解决方案
包未安装	pip install requests
网络问题	切换国内源
忘记 import	import requests
同名文件冲突	重命名 requests.py
路径不在PYTHONPATH	添加 site-packages
pip过旧	升级 pip
版本冲突	指定 requests==2.31.0

---

六、进阶可视化：排查进度甘特图

---

💡 总结：
requests 模块报错，本质是 安装、环境、路径、版本 四个维度问题。逐一排查，总能找到解决方案。

---

温馨提示🔔

更多Bug解决方案请查看 ==> 全栈Bug解决方案专栏 https://blog.csdn.net/lyzybbs/category_12988910.html

---

作者✍️名片