【Python系列Bug修復PyCharm控制臺pip install報錯】如何解決pip安裝報錯ModuleNotFoundError: No module named ‘notebook’問題

一、摘要

在使用 PyCharm 進行 Python 開發時，常常需要通過 pip install 安裝第三方包。但有時即便已經安裝成功，運行代碼或在控制臺中依然會報出如下錯誤：

ModuleNotFoundError: No module named ‘notebook’

本文將從開發場景、技術細節入手，深入剖析該異常出現的原因，并提供覆蓋各種可能性的多種解決方案，幫助大家快速定位并修復此類 pip install 相關問題。

---

二、開發環境

• 操作系統：macOS（任意新版均適用）
• Python 版本：3.8 / 3.9 / 3.10 / 3.11
• IDE：PyCharm 2025
• pip 版本：如非最新版建議升級至最新

---

三、問題重現

在 PyCharm 的 Terminal 或者 Run Console 中執行：

pip install notebook
python -c "import notebook"

即使提示安裝成功，卻拋出：

ModuleNotFoundError: No module named 'notebook'

出現該問題通常是因為 IDE 和系統終端使用了不同的 Python 解釋器或環境，或者包安裝過程出現了路徑、權限、網絡等異常。

---

四、解決方案

（一）確認解釋器一致性

1. 打開 PyCharm 設置：

   • Preferences -> Project: xxx -> Python Interpreter
   • 確認當前 Project 使用的解釋器與你在終端 which python / which pip 指向的保持一致。

2. 如果不一致，可添加或切換至正確的環境。

（二）升級 pip 并切換國內源

pip install --upgrade pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

網絡不穩定或訪問受限時，切換到國內鏡像可以大幅提升安裝成功率。

（三）檢查模塊名與包名

有時包名與模塊名并不完全相同，如 opencv-python vs cv2。

• 確保在 pip install <package> 中使用的是正確的包名。
• 在代碼中使用 import <module> 時請檢查拼寫是否與實際模塊名一致。

（四）添加 __init__.py 或調整導入方式

• 對于自建 package，確保每個子目錄下都有空的 __init__.py 文件，以便被識別為模塊。

• 若使用相對導入遇到問題，嘗試改為絕對導入：

  from mypackage.module import MyClass
  

（五）設置或更新 PYTHONPATH

1. 在終端或 IDE 中設置環境變量：

   export PYTHONPATH="$PYTHONPATH:/path/to/your/module"
   

2. 在 PyCharm 中可在 Run/Debug Configurations 的 Environment variables 中添加相同配置。

（六）避免同名沖突

若項目根目錄或工作目錄下存在與第三方包同名的文件/文件夾，Python 會優先加載本地文件。

• 將自定義腳本或文件夾改名，或使用虛擬環境隔離。

（七）使用虛擬環境（強烈推薦）

python -m venv venv
source venv/bin/activate
pip install notebook

• 保障環境隔離，減少全局沖突。

（八）高級排查流程（Mermaid 流程圖示例）

---

五、總結對照表

場景 / 問題	解決方案	示例命令
模塊未安裝或包名錯誤	pip install <正確包名>	pip install notebook
網絡不通或超時	切換國內源	pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
忘記 import	在代碼中添加 import <module>	import notebook
缺少 __init__.py	在包目錄下新增空文件	touch package/__init__.py
包版本與需求不符	指定版本安裝	pip install notebook==6.5.1
自定義包名沖突	重命名本地同名文件或文件夾	mv notebook.py my_notebook.py
PYTHONPATH 未設置或不包含目標路徑	設置環境變量或在 IDE 中配置	export PYTHONPATH=$PYTHONPATH:/my/modules
不當的相對導入	改為絕對導入	from mypkg.module import func
pip 版本過舊	升級 pip	pip install --upgrade pip
權限問題	使用 sudo 或虛擬環境	sudo pip install notebook

---

更多Bug解決方案請查看==>全棧Bug解決方案專欄https://blog.csdn.net/lyzybbs/category_12988910.html