【Python系列Bug修復PyCharm控制臺pip install報錯】如何解決pip安裝報錯ModuleNotFoundError: No module named ‘keras’問題
摘要
在使用 PyCharm 進行深度學習項目開發時，常常需要通過 pip install keras 來安裝 Keras 庫。但有時即便命令執行成功，運行代碼時依舊出現以下異常：
ModuleNotFoundError: No module named ‘keras’
這種問題困擾了不少開發者，尤其是在 macOS 環境下結合 PyCharm 2025 新版本使用虛擬環境時。本文將深入剖析該異常產生的開發場景與技術細節，并提供超詳細的解決方案，幫助大家快速定位并徹底修復此類 pip install 問題。
文章目錄
- 【Python系列Bug修復PyCharm控制臺pip install報錯】如何解決pip安裝報錯ModuleNotFoundError: No module named ‘keras’問題
- 摘要
- 一、開發環境
- 二、問題場景與復現
- 三、原因分析
- 四、解決方案
- 1. 檢查解釋器與包安裝路徑
- 2. 切換國內鏡像源并升級 pip
- 3. 確認包名與模塊名
- 4. 添加或檢查 `__init__.py`
- 5. 設置或更新 PYTHONPATH
- 6. 避免相對導入誤用
- 7. 清理 pip 緩存
- 8. 驗證包版本兼容性
- 五、總結
一、開發環境
- 操作系統：macOS 13.x（Apple Silicon M1/M2 兼容）
- Python 版本：Python 3.10.x
- IDE：PyCharm 2025.1.2
- 虛擬環境：venv / Conda
- 網絡：國內環境，部分場景需配置鏡像源
二、問題場景與復現
當在 PyCharm 的 Terminal 或者 Run Configuration 中執行以下命令時：
pip install keras
顯示安裝成功（或已安裝最新版本），但在代碼中導入時：
import keras
依然報錯：
ModuleNotFoundError: No module named 'keras'
引用：該異常通常源于環境隔離或路徑配置不當，排查時要先確認 PyCharm 終端與代碼運行所用解釋器是否一致。
三、原因分析
- 模塊未真正安裝到當前解釋器
- PyCharm 使用的解釋器不是預期的虛擬環境
- 自定義包名與官方包名沖突
- 環境變量（PYTHONPATH）未包含項目或模塊路徑
- 相對導入或
__init__.py配置錯誤 - pip 版本過舊導致安裝失敗或路徑混亂
四、解決方案
1. 檢查解釋器與包安裝路徑
which python
which pip
pip show keras
- 確認
pip對應同一 Python 解釋器 - 在 PyCharm 的 Settings → Project → Python Interpreter 中，選擇與 Terminal 一致的解釋器
2. 切換國內鏡像源并升級 pip
pip install --upgrade pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip install keras -U
3. 確認包名與模塊名
有時安裝
tensorflow會包含keras子模塊，可直接：
pip install tensorflow
或在代碼中：
from tensorflow import keras
4. 添加或檢查 __init__.py
- 確保自定義模塊路徑下存在空的
__init__.py文件，以便 Python 將其識別為包
5. 設置或更新 PYTHONPATH
- 在 macOS 下，可在終端或 PyCharm 環境變量中添加：
export PYTHONPATH="/Users/yourname/project/src:$PYTHONPATH"
6. 避免相對導入誤用
- 使用絕對導入：
# 錯誤
from ..mysubmodule import foo# 正確
from project.mysubmodule import foo
7. 清理 pip 緩存
pip cache purge
pip install keras
8. 驗證包版本兼容性
| 方案 | 說明 |
|---|---|
pip install keras==2.10.0 | 如果最新版不兼容，嘗試回滾到兼容版本 |
pip install tensorflow | 使用 TensorFlow 內置的 Keras 子模塊 |
conda install keras | Conda 環境下一鍵安裝 |
python -m pip install | 避免 PATH 沖突，使用模塊方式執行 pip |
五、總結
本文通過排查解釋器、鏡像源、包名沖突、路徑配置、緩存清理、相對導入等多種常見場景，詳細介紹了如何解決 PyCharm 控制臺下 pip install 后仍報 ModuleNotFoundError: No module named ‘keras’ 的問題。希望能夠幫助大家快速定位并修復此類環境配置問題。
更多Bug解決方案請查看==>全棧Bug解決方案專欄https://blog.csdn.net/lyzybbs/category_12988910.html
)
