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

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

摘要

在使用 PyCharm 开发 Python 项目时，经常需要在控制台（Terminal）或 Run 窗口里通过 pip install 安装第三方包。但有时会出现诸如 ModuleNotFoundError: No module named 'requests' 的报错，导致无法正常导入、使用已安装的包。本文从开发场景、环境配置、常见原因出发，结合多种解决方案，帮助你快速定位并解决 pip 安装报错问题。

---

1 开发环境

以下为本文复现问题并验证解决方案所用的软硬件环境

项目	版本 / 说明
操作系统	macOS 13.4
Python	3.10.12
PyCharm	2025.1.2 Community Edition
pip	23.1.2

---

2 问题现象

在 PyCharm 控制台执行：

pip install requests

虽然没有报错，但在代码中：

import requests

却提示：

ModuleNotFoundError: No module named 'requests'

“明明安装了 requests，为什么还是找不到？”

---

3 诊断流程

是否一致

是

否

有问题

无问题

检查环境解释器

相同环境?

检查路径配置

切换或配置正确的 Interpreter

调整 PYTHONPATH 或 Interpreter

继续往下排查

1. 确认 PyCharm 使用的 Interpreter 与终端 pip 作用的环境是否一致
2. 检查项目的 PYTHONPATH（或 Project Structure 中 Source Roots）
3. 确认是否有同名文件夹/包导致了导入冲突

---

4 常见解决方案

序号	原因分类	解决思路
1	module 包没安装或包名错误	pip install 模块名；确认拼写；pip show 模块名
2	网络问题	切换国内源：pip install -i https://pypi.tuna.tsinghua.edu.cn requests
3	忘了 import	在代码顶部加入：import requests
4	没有 init.py 文件	在自定义包根目录新建空的 __init__.py
5	package 版本不对	pip install 模块名==版本号
6	自定义包名与安装包名相同	重命名项目文件夹或自定义包，避免与 requests 冲突
7	PYTHONPATH 未设置	在环境变量或 PyCharm Settings → Project → Python Interpreter → Show All → Paths 中添加模块所在路径
8	相对导入不当	使用绝对导入：from mypkg.submodule import foo
9	pip 版本不是最新版	pip install --upgrade pip
10	多环境管理工具（如 conda）未激活	conda activate env_name 或 source venv/bin/activate

---

5 深入排查与扩展可能性

1. 虚拟环境问题

   • 有时在全局环境与虚拟环境中切换不当，导致安装到系统环境，但运行时却使用虚拟环境。
   • 解决：在 PyCharm 中重新创建或手动指定正确的虚拟环境。

2. 权限问题

   在 macOS/Linux 下，如果使用全局 pip install，可能会因为权限不足而“安装”失败但无明显报错。

   • 解决：使用 --user 参数或切换到管理员：

     pip install --user requests
     sudo pip install requests
     

3. 缓存及残余文件

   • 有时包残留旧版本或下载缓存导致安装后依旧异常。
   • 清理缓存：pip cache purge，然后重装。

4. 镜像源偶发同步延迟

   • 某些镜像源同步不及时，可能安装了旧版本或缺少某些构建文件。
   • 可临时切回官方源或其他镜像。

5. PyCharm 控制台与系统终端环境变量差异

   • PyCharm 的 Terminal 可能继承了与系统终端不同的 PATH。
   • 在 PyCharm Terminal 中执行 which python、which pip 与系统终端比对。

---

6 总结

关键点	建议操作
环境一致性	确保 PyCharm Interpreter 与终端 pip 对应同一环境
包名与自定义模块冲突	避免自定义包与第三方包同名
网络与源可靠性	切换至稳定、更新及时的镜像源
权限与缓存	使用 --user、sudo；定期清理 pip 缓存
路径与导入方式	配置 PYTHONPATH；优先使用绝对导入

---

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