如何徹底搞定 PyCharm 中 pip install 報錯 ModuleNotFoundError: No module named ‘requests’ 的問題

在使用 PyCharm 開發 Python 項目時，ModuleNotFoundError: No module named 'requests' 是一個常見但令人頭疼的問題。本篇博文將從環境配置、原因分析到多種解決方案，幫助你徹底搞定該錯誤，確保在 PyCharm 中順利使用 requests 庫。

---

作者簡介

貓頭虎是誰？

大家好，我是 貓頭虎，貓頭虎技術團隊創始人，也被大家稱為貓哥。我目前是COC北京城市開發者社區主理人、COC西安城市開發者社區主理人，以及云原生開發者社區主理人，在多個技術領域如云原生、前端、后端、運維和AI都具備豐富經驗。

我的博客內容涵蓋廣泛，主要分享技術教程、Bug解決方案、開發工具使用方法、前沿科技資訊、產品評測、產品使用體驗，以及產品優缺點分析、橫向對比、技術沙龍參會體驗等。我的分享聚焦于云服務產品評測、AI產品對比、開發板性能測試和技術報告。

目前，我活躍在CSDN、51CTO、騰訊云、阿里云開發者社區、知乎、微信公眾號、視頻號、抖音、B站、小紅書等平臺，全網粉絲已超過30萬。我所有平臺的IP名稱統一為貓頭虎或貓頭虎技術團隊。

我希望通過我的分享，幫助大家更好地掌握和使用各種技術產品，提升開發效率與體驗。

---

作者名片 ??

• 博主：貓頭虎
• 全網搜索關鍵詞：貓頭虎
• 作者微信號：Libin9iOak
• 作者公眾號：貓頭虎技術團隊
• 更新日期：2025年03月21日
• 🌟 歡迎來到貓頭虎的博客 — 探索技術的無限可能！

---

加入我們AI共創團隊 🌐

• 貓頭虎AI共創社群矩陣列表：
  • 點我進入共創社群矩陣入口
  • 點我進入新矩陣備用鏈接入口

加入貓頭虎的共創圈，一起探索編程世界的無限可能！ 🚀

部分專欄鏈接：

🔗 精選專欄：

• 《面試題大全》 — 面試準備的寶典！
• 《IDEA開發秘籍》 — 提升你的IDEA技能！
• 《100天精通鴻蒙》 — 從Web/安卓到鴻蒙大師！
• 《100天精通Golang（基礎入門篇）》 — 踏入Go語言世界的第一步！

---

正文

---

目錄

1. 問題描述
2. 錯誤原因分析
3. 解決方案一：在終端使用 pip 安裝
4. 解決方案二：確認并切換正確的 Python 解釋器
5. 解決方案三：通過 PyCharm GUI 安裝依賴
6. 解決方案四：多版本 Python 與環境變量沖突的處理
7. 解決方案五：虛擬環境（venv / conda）最佳實踐
8. 從零開始：一步步排查清單
9. 常見誤區與注意事項
10. 總結與推薦

---

問題描述

在 PyCharm 中運行腳本時，執行以下代碼常常會報錯：

import requests
# …

終端或控制臺輸出：

ModuleNotFoundError: No module named 'requests'

即使你已經在命令行中運行過 pip install requests 并且顯示安裝成功，PyCharm 仍然提示找不到該模塊。本質上，這是因為安裝包的環境與 PyCharm 運行腳本所用的環境不一致導致的。

---

錯誤原因分析

1. 全局環境 vs 虛擬環境不一致

   • 命令行的 pip 默認操作全局 Python 環境，而 PyCharm 項目常配置了獨立的 venv 或 conda 環境。

2. 多版本 Python 并存導致的 pip 對應錯誤

   • Windows/macOS 上同時裝了 Python2.x 和 Python3.x，pip 有時指向 Python2，pip3 指向 Python3，但你腳本用的卻是另一個版本。

3. PyCharm 解釋器配置錯誤

   • 項目 Interpreter 指向了系統解釋器，卻誤以為是在虛擬環境中安裝包。

4. 環境變量 PATH 配置混亂

   • 系統環境變量配置了多個 Python 路徑，導致執行 pip 和 python 時調用了不同的可執行文件。

理解這幾點后，我們可以有針對性地解決。

---

解決方案一：在終端使用 pip 安裝

1. 升級 pip

   python -m pip install --upgrade pip
   

2. 安裝 requests

   • Python 2:

     pip install requests
     

   • Python 3:

     pip3 install requests
     

3. 驗證安裝位置

   python -c "import requests; print(requests.__file__)"
   

   輸出路徑應在你期望的 Python 安裝目錄下。如果不是，說明 pip 安裝到了其他環境。

Tip: 在 PyCharm 所使用的 Terminal 窗口中執行上述命令，可以保證使用的是該項目配置的環境終端。

---

解決方案二：確認并切換正確的 Python 解釋器

1. 打開 PyCharm，依次進入：
   File → Settings（macOS 為 PyCharm → Preferences）→ Project: 你的項目名 → Python Interpreter

2. 在右側下拉框中，查看當前選中的解釋器：

   • 系統解釋器（System Interpreter）
   • 虛擬環境（Virtualenv Environment）
   • Conda Environment

3. 若與安裝 requests 的環境不一致，點擊齒輪圖標 → Add… → 選擇或創建正確的解釋器/環境。

4. 切換后，PyCharm 會自動索引該環境中的所有包，確保 requests 已顯示在已安裝列表中。

---

解決方案三：通過 PyCharm GUI 安裝依賴

若你對命令行不熟悉，PyCharm 提供了圖形化的包管理界面：

1. 打開 Settings → Project Interpreter 界面。
2. 在已安裝包列表下方，點擊 “+” 按鈕。
3. 在彈出的對話框中輸入 requests，選中 requests 后點擊 Install Package。
4. 安裝完成后，requests 會出現在包列表中，無需重啟即可直接導入使用。

---

解決方案四：多版本 Python 與環境變量沖突的處理

如果你在系統中安裝了多個 Python 版本，可能會出現：

$ which python
/usr/bin/python
$ which pip
/usr/local/bin/pip

它們并不指向同一個目錄。解決方法：

1. 明確使用版本

   python3.9 -m pip install requests
   

   或者在 Windows：

   py -3.9 -m pip install requests
   

2. 檢查環境變量

   • Windows：右鍵 此電腦 → 屬性 → 高級系統設置 → 環境變量，確保 PATH 中 Python 路徑順序正確。
   • macOS/Linux：檢查 ~/.bash_profile、~/.zshrc 等中 export PATH 配置。

---

解決方案五：虛擬環境（venv / conda）最佳實踐

使用 venv

1. 在項目根目錄創建虛擬環境：

   python3 -m venv venv
   

2. 激活環境：

   • macOS/Linux:

     source venv/bin/activate
     

   • Windows:

     .\venv\Scripts\activate
     

3. 安裝 requests：

   pip install --upgrade pip
   pip install requests
   

在 PyCharm 中，將該 venv 目錄下的解釋器添加為項目 Interpreter。

使用 Conda

1. 創建并激活環境：

   conda create -n myenv python=3.9
   conda activate myenv
   

2. 安裝 requests：

   conda install requests
   

3. 在 PyCharm 中，選擇該 Conda 環境作為項目 Interpreter。

---

從零開始：一步步排查清單

1. 確認報錯

   • 運行腳本，復制完整的錯誤堆棧。

2. 檢查 pip 安裝

   pip show requests
   # 或 python -m pip show requests
   

3. 確定 pip 與 python 對應關系

   which pip
   which python
   # Windows: where pip; where python
   

4. 查看 PyCharm Interpreter

   • 確保與上述 pip/python 一致。

5. 在 PyCharm Terminal 重復安裝

   • 確保環境激活后，執行 pip install requests。

6. 使用 GUI 安裝

   • 備選方案，快速驗證。

7. 運行驗證腳本

   import requests
   print(requests.__version__)
   

---

常見誤區與注意事項

• 在系統終端安裝，卻未激活虛擬環境

• 誤以為 PyCharm Terminal 等同于系統終端

• 多次安裝后未重啟 PyCharm（有時需要重啟 IDE 以刷新包索引）

• 依賴文件 requirements.txt 與環境同步缺失

  • 推薦使用：

    pip freeze > requirements.txt
    pip install -r requirements.txt
    

---

總結與推薦

1. 優先使用虛擬環境（venv 或 conda），隔離項目依賴。
2. 在 PyCharm Terminal 中執行 pip，減少環境誤差。
3. 必要時用 GUI 安裝，更加直觀。
4. 遇到多版本沖突，使用 python -m pip 明確指定環境。

通過以上方法，你可以徹底搞定 PyCharm 中 pip install 報錯 ModuleNotFoundError: No module named 'requests' 的問題，保證開發環境的穩定與高效。祝你編程順利！

粉絲福利

---

👉 更多信息：有任何疑問或者需要進一步探討的內容，歡迎點擊文末名片獲取更多信息。我是貓頭虎博主，期待與您的交流！ 🦉💬

---

聯系我與版權聲明 📩

• 聯系方式：
  • 微信: Libin9iOak
  • 公眾號: 貓頭虎技術團隊
• 版權聲明：
  本文為原創文章，版權歸作者所有。未經許可，禁止轉載。更多內容請訪問貓頭虎的博客首頁。

---

點擊???下方名片???，加入貓頭虎AI共創社群矩陣。一起探索科技的未來，共同成長。🚀