JupyterLab中itkwidgets扩展报错：Error displaying widget: model not found

问题详情 #

在JupyterLab安装jupyter-itkwidgets扩展后，运行下述代码时触发错误：

import vtk
import itk
from itkwidgets import view

viewer = view(data_3D, ui_collapsed=True)
viewer.interpolation = False

viewer

错误提示：

Error displaying widget: model not found

已完成的排查操作：

• 执行jupyter nbextension enable --py --sys-prefix widgetsnbextension，成功启用Jupyter widgets
• 执行pip install itkwidgets --upgrade，更新itkwidgets至最新版
• 当前ipywidgets版本为7.8.1

解决步骤 #

1. 安装适配JupyterLab的itkwidgets扩展 #

JupyterLab与经典Notebook的扩展机制不兼容，你之前操作的是经典Notebook的widgets配置，需安装Lab专用扩展：

• 若使用JupyterLab 2.x及以下版本，执行：

jupyter labextension install @jupyter-widgets/jupyterlab-manager itkwidgets

• 若使用JupyterLab 3.x及以上版本（支持pip直接安装Lab扩展），执行：

pip install itkwidgets[labextension]

2. 重建JupyterLab（可选，视版本而定） #

安装扩展后，执行重建命令确保扩展生效：

jupyter lab build

注：JupyterLab 3.x+通常无需手动执行此命令，但若问题仍存在可尝试

3. 验证ipywidgets兼容性 #

itkwidgets与ipywidgets存在版本依赖，你当前的7.8.1版本可能存在兼容问题，可尝试升级：

pip install ipywidgets --upgrade

升级后重新启用经典Notebook的widgets扩展（不影响JupyterLab）：

jupyter nbextension enable --py widgetsnbextension --sys-prefix

4. 重启JupyterLab #

完全关闭当前JupyterLab进程，重新启动服务后再次测试代码。

5. 检查依赖版本匹配度 #

执行下述命令查看相关包版本，确认itk、vtk、itkwidgets与ipywidgets版本兼容：

pip list | grep -E "itk|vtk|itkwidgets|ipywidgets"

若存在版本不匹配，调整对应包版本至兼容范围。

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