Jupyter Lab打开已保存笔记本时图表显示widget模型未找到错误求助

开发者阿泽

2026-8-6

问题描述

使用%matplotlib widget在Jupyter Lab中绘制图表时，实时运行完全正常，但保存笔记本后重新打开，图表先显示“Loading widget...”，几秒后提示“Error displaying widget: model not found”。已更新到jupyterlab 3.5.2、ipympl 0.9.2、ipywidgets 7.6.5、python 3.9.13、matplotlib 3.5.3版本，问题仍存在。

复现代码：

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

x = np.linspace(-4, 4, 100)
y = np.sin(x)

plt.plot(x,y)

解决方案

重建Jupyter Lab扩展缓存
扩展缓存损坏可能导致widget加载失败，执行以下命令清理并重建：
```
jupyter lab clean
jupyter lab build
```
等待build完成后重启Jupyter Lab。
验证ipympl扩展状态
检查扩展是否正常启用：
```
jupyter labextension list
```
确保@jupyter-widgets/jupyterlab-manager和jupyter-matplotlib均显示enabled。若缺失，手动安装：
```
jupyter labextension install @jupyter-widgets/jupyterlab-manager jupyter-matplotlib
```
升级ipywidgets到兼容版本
ipywidgets 7.x与Jupyter Lab 3.5.x可能存在兼容性问题，尝试升级到8.x系列：
```
pip install --upgrade ipywidgets
```
升级后重新执行jupyter lab build并重启服务。
强制同步widget状态后保存
保存前执行代码关闭所有widget，确保状态正确序列化：
```
from ipywidgets import Widget
Widget.close_all()
```
重新运行绘图代码后再保存笔记本。
清空浏览器缓存
浏览器缓存的旧扩展文件可能引发冲突，清空缓存后以无痕模式打开Jupyter Lab加载笔记本。