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

---

作者??名片