如何解决Jupyter Notebook交互式绘图时的"Javascript Error: IPython is not defined"错误

架构老林

2026-7-2

解决Jupyter Notebook中%matplotlib notebook的"IPython is not defined"错误

问题根源

更新Anaconda后，matplotlib的notebook交互式后端与新版Jupyter的前端组件（如ipywidgets）版本不兼容，导致前端无法识别IPython对象。

降级matplotlib到兼容版本
打开Anaconda Prompt（或终端）执行：
```
conda install matplotlib=3.5.3
```
该版本与新版Jupyter环境兼容性良好，能避免前端交互报错。
替换为%matplotlib widget后端
无需降级，直接改用更适配新版环境的交互式后端，修改代码如下：
```
import matplotlib.pyplot as plt
%matplotlib widget  # 替换原%matplotlib notebook
plt.figure()
plt.plot(x, y)
plt.show()
```
widget后端是notebook的替代方案，交互功能一致且稳定性更高。
重置Jupyter前端配置
若前两种方法无效，重置Jupyter的前端静态文件：
```
jupyter nbextension enable --py widgetsnbextension
jupyter nbextension install --py widgetsnbextension --user
```
执行完成后重启Jupyter Notebook即可。