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

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

---

摘要

在Python开发过程中，使用pip install安装第三方依赖包时，开发者经常会遇到ModuleNotFoundError: No module named 'xxx'的报错。本文将以 requests-html模块安装报错 为案例，结合实际 PyCharm 2025、macOS 环境 的使用场景，详细分析导致问题的可能原因与对应解决方案，并从包管理、环境配置、网络代理、代码导入等多个角度扩展排查思路，帮助开发者快速定位和修复此类错误。

---

一、开发环境说明

在本文案例中，开发环境如下：

• 操作系统：macOS Sonoma
• IDE工具：PyCharm 2025 专业版
• Python版本：3.11.8 (通过 pyenv 安装)
• 依赖管理：pip 24.0 + venv 虚拟环境

---

二、常见报错场景复现

在PyCharm中执行如下代码：

from requests_html import HTMLSessionsession = HTMLSession()

运行后控制台提示：

ModuleNotFoundError: No module named 'requests-html'

即便在终端执行了：

pip install requests-html

依然无法解决。这类问题往往出现在多环境、多路径配置不当或依赖未成功安装的情况下。

---

三、pip install 报错原因详解与解决方案

下面将从多个层次逐一分析：

1. 模块未安装 / 包名拼写错误

• 可能误写为request-html（少了s）
• 解决方法：执行

pip install requests-html

并确认输出中显示 Successfully installed requests-html。

---

2. 网络问题 / 源地址不可用

海外PyPI下载速度慢或连接超时，常见报错：

Could not fetch URL https://pypi.org/simple/requests-html/: Connection timed out

解决方案：切换国内源

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests-html

---

3. pip 版本过低

部分新包依赖 pep517 构建机制，旧pip不兼容。
解决方案：

pip install --upgrade pip

---

4. 忘记 import 或导入路径错误

即使安装了包，如果代码中写成：

import request_html

会报错，需修改为：

from requests_html import HTMLSession

---

5. 没有 __init__.py 文件

自定义本地包缺少__init__.py，导致无法识别为模块。
解决：在目录下新建空文件：

touch __init__.py

---

6. 包版本不兼容

某些Python版本不支持旧版依赖。
解决方法：指定版本：

pip install requests-html==0.10.0

---

7. 自定义包名冲突

若自己写了一个requests_html.py，会与系统包冲突，导致导入本地文件而非第三方库。
解决：修改本地文件名。

---

8. PYTHONPATH 配置问题

PyCharm虚拟环境与系统Python不一致时，pip安装到了全局，但运行使用了另一个环境。

解决方法：

• 在PyCharm中确认：
  Preferences -> Project -> Python Interpreter 选择正确环境。
• 或在终端执行：

which python
python -m pip install requests-html

---

9. 相对导入错误

在多模块工程里，错误使用：

from .requests_html import HTMLSession

应改为：

from requests_html import HTMLSession

---

10. 多版本Python冲突

macOS上同时存在python3.9和python3.11，可能pip安装到了另一个版本。
解决：

python3.11 -m pip install requests-html

---

四、可视化流程图：排查思路

---

五、总结对比表

错误原因	排查方法	解决方案示例
包未安装 / 拼写错误	执行 pip list 检查是否存在	pip install requests-html
网络超时	检查是否卡在 PyPI	pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests-html
pip 版本过低	查看 pip --version	pip install --upgrade pip
导入错误	检查代码 import 语句	from requests_html import HTMLSession
缺少 __init__.py	检查本地自建模块目录	touch __init__.py
包版本不对	查看 Python 兼容性	pip install requests-html==0.10.0
本地包名冲突	检查工程文件	修改文件名
PYTHONPATH 配置错误	对比 PyCharm 与终端解释器	python -m pip install requests-html
相对导入误用	查看 import 路径	改为绝对导入
多Python版本冲突	使用 which python 或 pyenv 检查	python3.11 -m pip install

---

---

六、额外技巧：提升pip install成功率

• 使用 虚拟环境 管理依赖：python -m venv venv
• 使用 conda 替代 pip 安装部分依赖：conda install requests-html
• 使用 代理加速：

pip install requests-html --proxy http://127.0.0.1:7890

• 避免 系统权限冲突：

pip install --user requests-html

---

七、结语

通过上述多维度排查，可以快速解决 ModuleNotFoundError: No module named 'requests-html' 报错问题。建议在遇到 pip install 异常时，不仅关注 安装命令 本身，更要结合 环境、依赖、路径 等多方面综合分析。

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

---