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

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

一、摘要

文章目录

[【Python系列Bug修复PyCharm控制台pip install报错】如何解决pip安装报错ModuleNotFoundError: No module named 'plotly'问题](#【Python系列Bug修复PyCharm控制台pip install报错】如何解决pip安装报错ModuleNotFoundError: No module named ‘plotly’问题)
一、摘要
二、开发环境
三、问题现象
四、解决方案
- [4.1 模块包未安装、包名错误](#4.1 模块包未安装、包名错误)
- [4.2 网络问题------切换国内源](#4.2 网络问题——切换国内源)
- [4.3 忘记在代码中 `import`](#4.3 忘记在代码中 import)
- [4.4 缺少 `init.py` 文件](#4.4 缺少 __init__.py 文件)
- [4.5 包版本不兼容](#4.5 包版本不兼容)
- [4.6 包名冲突](#4.6 包名冲突)
- [4.7 PYTHONPATH 未设置](#4.7 PYTHONPATH 未设置)
- [4.8 相对导入不当](#4.8 相对导入不当)
- [4.9 pip 版本过旧](#4.9 pip 版本过旧)
- [4.10 虚拟环境混用](#4.10 虚拟环境混用)
- [4.11 权限问题](#4.11 权限问题)
- [4.12 缓存问题------清理 pip 缓存](#4.12 缓存问题——清理 pip 缓存)
- [4.13 证书问题](#4.13 证书问题)
- [4.14 代理配置错误](#4.14 代理配置错误)
- [4.15 Python 解释器选择错误](#4.15 Python 解释器选择错误)
五、解决方案汇总表

在使用 PyCharm 2025 开发 Python 项目时，常常需要通过 pip install 安装第三方库，但有时即便安装成功，控制台依然报出 ModuleNotFoundError: No module named 'plotly' 错误。本篇文章将从实际开发场景出发，深入剖析该异常产生的技术细节，并提供多种可行的解决方案，帮助大家快速定位并修复此类 pip 安装问题。

二、开发环境

操作系统：macOS 12.x / 13.x
Python 版本：3.9.x / 3.10.x（根据项目选用）
IDE：PyCharm 2025.1
pip 版本：21.0.1 及以上
虚拟环境：venv / conda

三、问题现象

当在 PyCharm 控制台或运行脚本时，明明已执行

bash 复制代码

pip install plotly

安装过程也无报错，但在代码中：

python 复制代码

import plotly

依然提示：

复制代码

ModuleNotFoundError: No module named 'plotly'

此时既无法正常导入，也无法使用 Plotly 绘图。

四、解决方案

4.1 模块包未安装、包名错误

检查包是否安装
bash 复制代码
```
pip show plotly
```
正确安装包
bash 复制代码
```
pip install plotly
```

4.2 网络问题------切换国内源

bash 复制代码

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

4.3 忘记在代码中 `import`

python 复制代码

# 确保已导入
import plotly

4.4 缺少 `init.py` 文件

自定义模块下需包含空白的 __init__.py，否则无法识别为包。

4.5 包版本不兼容

指定兼容版本安装：

bash 复制代码

pip install plotly==5.13.0

4.6 包名冲突

避免自定义包或脚本文件名与第三方库同名，例如：plotly.py。

4.7 PYTHONPATH 未设置

bash 复制代码

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

4.8 相对导入不当

使用绝对导入：
python 复制代码
```
from your_package.submodule import foo
```
避免在脚本直接运行时出现相对导入错误。

4.9 pip 版本过旧

升级 pip：

bash 复制代码

pip install --upgrade pip

4.10 虚拟环境混用

确认 PyCharm 使用的解释器与终端相同。
在 PyCharm 的 Settings → Project Interpreter 中检查。

4.11 权限问题

macOS 下需 sudo：
bash 复制代码
```
sudo pip install plotly
```
建议使用 --user 安装：
bash 复制代码
```
pip install --user plotly
```

4.12 缓存问题------清理 pip 缓存

bash 复制代码

pip cache purge
pip install plotly

4.13 证书问题

企业内网或旧系统可能因证书失效导致安装中断，可添加 --trusted-host：

bash 复制代码

pip install plotly --trusted-host pypi.org --trusted-host files.pythonhosted.org

4.14 代理配置错误

bash 复制代码

export HTTP_PROXY="http://proxy.example.com:3128"
export HTTPS_PROXY="https://proxy.example.com:3128"
pip install plotly

4.15 Python 解释器选择错误

在脚本顶部添加 shebang 或在 PyCharm 运行配置中指定正确的解释器。

五、解决方案汇总表

解决方向	说明
模块包未安装或包名错误	使用 `pip show` 检查并正确安装
网络问题（切换国内源）	`-i https://pypi.tuna.tsinghua.edu.cn/simple`
忘记 import	在代码中添加 `import plotly`
缺少 `__init__.py`	在自定义包目录下添加空白文件
包版本不兼容	指定适配版本安装：`pip install plotly==版本号`
包名冲突	避免脚本/模块与第三方库同名
PYTHONPATH 未设置	添加模块路径到环境变量
相对导入使用不当	建议使用绝对导入
pip 版本过旧	`pip install --upgrade pip`
虚拟环境解释器不匹配	检查 PyCharm 的 Project Interpreter 设置
权限问题	使用 `sudo` 或 `--user` 选项
缓存问题	`pip cache purge` 清理缓存
证书问题	`--trusted-host` 信任仓库
代理配置	设置 `HTTP_PROXY`、`HTTPS_PROXY`
Python 解释器选择错误	确认脚本运行的 Python 路径

为了帮助更多开发者，如果您需要更多 Bug 解决方案，请查看 ==> 全栈Bug解决方案专栏 https://blog.csdn.net/lyzybbs/category_12988910.html。

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

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

一、摘要

文章目录

二、开发环境

三、问题现象

四、解决方案

4.1 模块包未安装、包名错误

4.2 网络问题------切换国内源

4.3 忘记在代码中 import

4.4 缺少 __init__.py 文件

4.5 包版本不兼容

4.6 包名冲突

4.7 PYTHONPATH 未设置

4.8 相对导入不当

4.9 pip 版本过旧

4.10 虚拟环境混用

4.11 权限问题

4.12 缓存问题------清理 pip 缓存

4.13 证书问题

4.14 代理配置错误

4.15 Python 解释器选择错误

五、解决方案汇总表

4.3 忘记在代码中 `import`

4.4 缺少 `init.py` 文件