如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘requests’ 问题

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

---

摘要

在日常Python开发过程中，pip install 是我们最常用的依赖安装命令之一。然而很多开发者在 PyCharm 控制台 中执行 pip install requests 或者安装其他第三方依赖时，经常会遇到 ModuleNotFoundError: No module named ‘xxx’ 这种典型报错。本文将围绕 开发环境、异常原因、解决方案 全面拆解这一问题，并给出一个面向实战的多维度排查指南。

---

一、开发场景背景

这个异常通常出现在以下典型场景：

• 使用 PyCharm 2025 控制台 安装依赖后，运行代码时仍旧提示找不到模块。
• 在 MacOS 系统 下多版本 Python 并存，pip 与 python 的执行环境不一致。
• 虚拟环境 未正确激活，导致安装的包被装到了系统环境之外。

引用说明：

ModuleNotFoundError: No module named ‘requests’
说明：解释器在当前环境中没有找到 requests 包。

---

二、开发环境说明

• 操作系统：MacOS
• Python 版本：Python 3.11（同样适用于 3.9 / 3.10 / 3.12）
• IDE：PyCharm 2025 (Community/Professional Edition)
• 包管理工具：pip, venv, conda（部分情况）

---

三、常见问题与解决方案

1. Module包没安装 / 包名拼写错误

运行：

pip install requests

注意大小写问题，Request、Requests 都是错误写法。

---

2. pip 与 python 解释器不匹配

有时候 pip 默认对应的是 python2 或系统路径。解决办法：

python3 -m pip install requests

或者指定解释器路径：

/Users/xxx/venv/bin/python -m pip install requests

---

3. 网络问题：切换国内镜像

国内环境经常出现 pip 下载失败。可以使用清华源：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests

配置全局镜像（Mac/Linux 下 ~/.pip/pip.conf）：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

Windows 下 pip.ini：

[global]
index-url = https://pypi.douban.com/simple/

---

4. 忘了 import 或 __init__.py 缺失

即使安装成功，如果 包路径下没有 __init__.py 文件，Python 解释器也可能无法识别。

---

5. 包版本不对 / 依赖冲突

指定版本安装：

pip install requests==2.31.0

如有冲突可先卸载再重装：

pip uninstall requests
pip install requests

---

6. 自定义包名冲突

如果自己建了一个文件夹叫 requests，运行时会优先导入你自己的包而不是第三方库，解决办法：改名或调整 PYTHONPATH。

---

7. PYTHONPATH 未配置

确认 PyCharm 项目解释器 是否选择了正确的虚拟环境。
路径不在 PYTHONPATH 下，可以在 .bashrc 或 .zshrc 里添加：

export PYTHONPATH=$PYTHONPATH:/Users/xxx/myproject

---

8. 相对导入错误

避免写成：

from .requests import get

正确写法：

import requests

---

9. pip 版本过旧

升级 pip：

pip install --upgrade pip

---

四、问题排查流程图

---

五、总结表格

问题原因	解决方案
包没安装 / 拼写错误	pip install requests
pip 与解释器不一致	python -m pip install requests
网络下载失败	使用国内镜像 pip 源
忘了 import	import requests
缺少 __init__.py 文件	添加 __init__.py
包版本不对	pip install requests==指定版本
包名冲突	修改自定义包名 / 调整 PYTHONPATH
路径不在 PYTHONPATH 下	export PYTHONPATH=...
相对导入错误	改为绝对导入
pip 版本过旧	pip install --upgrade pip

---

六、扩展思路

除了以上方案，还可以尝试：

• 使用 conda 管理环境：conda install requests
• 使用 requirements.txt 保持团队环境一致：pip install -r requirements.txt
• 使用 Poetry、pipenv 等现代依赖管理工具统一版本。

---

七、结尾

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

---

作者✍️名片