PyCharm中Jupyter Notebook的ipympl交互图表无工具栏问题求助

问题详情 #

运行ipympl官网示例代码：

%matplotlib ipympl
import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots()
x = np.linspace(0, 2*np.pi, 100)
y = np.sin(3*x)
ax.plot(x, y)

无法显示交互式工具栏按钮，已尝试以下场景：

• 不使用ipympl：仅生成静态图表，无交互性
• 使用ipympl：仍为静态图表，但样式与无ipympl时不同
• 仅设置Qt5Agg为后端：无法生成任何图表
• 同时使用ipympl和Qt5Agg后端：弹出空白卡死窗口

更换matplotlib 3.4.0、3.5.0、3.8.1版本后问题仍存在。

排查与解决步骤 #

1. 检查PyCharm的Python Scientific配置 #

打开PyCharm的File > Settings > Tools > Python Scientific：

• 取消勾选Show plots in toolwindow（该选项会强制使用静态后端，覆盖ipympl的交互设置）
• 确认Jupyter服务器绑定的是当前项目的虚拟环境，避免环境依赖混乱

2. 强制指定ipympl后端 #

在代码开头添加后端重置命令，清除之前的后端残留配置：

%matplotlib inline
%matplotlib ipympl
import matplotlib.pyplot as plt
import numpy as np

# 强制绑定ipympl后端
plt.switch_backend('module://ipympl.backend_nbagg')

fig, ax = plt.subplots()
x = np.linspace(0, 2*np.pi, 100)
y = np.sin(3*x)
ax.plot(x, y)

3. 重装兼容版本的依赖包 #

执行命令清理并安装经过验证的兼容版本组合，避免版本冲突：

pip uninstall -y matplotlib ipympl jupyter
pip install matplotlib==3.7.1 ipympl jupyter

若使用conda环境：

conda uninstall -y matplotlib ipympl jupyter
conda install matplotlib=3.7.1 ipympl jupyter

4. 验证纯Jupyter环境是否正常 #

在终端启动纯Jupyter Notebook（脱离PyCharm）运行相同代码：

• 若纯Jupyter能正常显示交互工具栏，说明问题出在PyCharm配置，建议更新PyCharm到最新稳定版，或切换使用"Jupyter Notebook"模式而非"Jupyter Lab"

5. 重置matplotlib配置 #

删除本地matplotlib配置文件，清除自定义设置干扰：

• Windows路径：C:\Users\<你的用户名>\.matplotlib\matplotlibrc
• macOS/Linux路径：~/.config/matplotlib/matplotlibrc
  删除后重新运行代码，matplotlib会生成默认配置

内容的提问来源于stack exchange，提问作者Alex