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

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

一、摘要

在使用 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 控制台或运行脚本时，明明已执行

pip install plotly

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

import plotly

依然提示：

ModuleNotFoundError: No module named 'plotly'

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

四、解决方案

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

1. 检查包是否安装

   pip show plotly
   

2. 正确安装包

   pip install plotly
   

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

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

4.3 忘记在代码中 import

# 确保已导入
import plotly

4.4 缺少 __init__.py 文件

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

4.5 包版本不兼容

指定兼容版本安装：

pip install plotly==5.13.0

4.6 包名冲突

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

4.7 PYTHONPATH 未设置

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

4.8 相对导入不当

• 使用绝对导入：

  from your_package.submodule import foo
  

• 避免在脚本直接运行时出现相对导入错误。

4.9 pip 版本过旧

升级 pip：

pip install --upgrade pip

4.10 虚拟环境混用

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

4.11 权限问题

• macOS 下需 sudo：

  sudo pip install plotly
  

• 建议使用 --user 安装：

  pip install --user plotly
  

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

pip cache purge
pip install plotly

4.13 证书问题

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

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

4.14 代理配置错误

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。