如何解决pip安装报错ModuleNotFoundError: No module named ‘jupyter-book’问题

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

摘要

在日常的Python开发中，我们经常会使用 pip install 来安装第三方库。但在 PyCharm 2025 控制台 下，有时候会遇到各种各样的报错，比如常见的：

ModuleNotFoundError: No module named ‘jupyter-book’

这种异常会打断开发节奏，让初学者和有经验的工程师都感到头疼。本文将结合典型的开发环境、常见的触发场景，并逐条分析导致该问题的技术细节与解决思路。
关键词：pip install、PyCharm 2025、ModuleNotFoundError、jupyter-book、Python虚拟环境

---

一、开发环境说明

本文出现问题的开发环境如下：

• 操作系统：macOS 15
• Python版本：Python 3.11
• IDE：PyCharm 2025
• 网络环境：公司代理 / 家庭宽带
• 目标安装包：jupyter-book

---

二、常见报错触发场景

1. 在 PyCharm Terminal 中执行：

   pip install jupyter-book
   

   却发现安装完成后，仍然提示 ModuleNotFoundError。

2. 在 PyCharm 配置的 虚拟环境 中库缺失，但在系统全局环境中已经安装。

3. 使用 conda 和 pip 混合环境时，路径不一致导致找不到包。

💡 很多时候，问题并不在于“库不存在”，而是在于 路径、环境、版本冲突。

---

三、核心问题分析与解决方案

1. module包没安装，或者包名错误

pip install jupyter-book

注意：有些包名与导入名不同，比如 beautifulsoup4 实际 import bs4。

---

2. 网络问题，使用国内源

国内用户经常遇到网络问题，可切换国内源：

pip install jupyter-book -i https://pypi.tuna.tsinghua.edu.cn/simple

推荐永久修改 pip.conf：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

---

3. 忘记import

有时库已经装好，但你写成：

import jupyterbook

正确的是：

import jupyter_book

---

4. 缺少 __init__.py 文件

如果是自建模块目录，必须包含：

my_project/utils/__init__.pyhelper.py

---

5. package包版本不对

jupyter-book 新版本可能与本地 Python 版本不兼容。
解决办法：

pip install jupyter-book==0.15.1

---

6. 自定义包名与安装的包名冲突

比如你自己写了一个 jupyter.py 文件，那么 import jupyter_book 时会导入错误。
解决办法：重命名本地文件。

---

7. 没有设置PYTHONPATH

如果你要导入本地包，需要在 PyCharm -> Run/Debug Configurations -> Environment variables 中配置：

PYTHONPATH=./src

---

8. 相对导入使用错误

包内应使用：

from .helper import func

不要写：

from helper import func

---

9. pip版本过旧

升级 pip：

python -m pip install --upgrade pip

---

四、问题定位流程图

---

---

五、常见问题总结表格

问题类别	典型场景	解决方案
包未安装	ModuleNotFoundError	pip install 正确包名
网络问题	无法下载	切换国内源
忘记导入	拼写错误	检查 import
路径错误	自建包未识别	加 __init__.py 或设置 PYTHONPATH
版本冲突	新旧版本不兼容	指定版本安装
包名冲突	自己写的同名模块	重命名本地文件
pip过旧	提示安装失败	升级 pip

---

六、总结与延伸

通过以上方法，基本可以解决 PyCharm 控制台下 pip install 报错 的大部分场景。

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

---