JupyterLab与Jupyter Notebook中ipywidgets无法显示：‘Error displaying widget’问题排查求助

架构老林

2026-4-14

问题描述

我在JupyterLab中尝试使用ipywidgets时，遇到了Error displaying widget的报错。以下是能复现该问题的最小示例代码：

import ipywidgets as widgets
from IPython.display import display
slider = widgets.IntSlider(min=0, max=100)  
display(slider)

已完成的检查

1. 环境版本信息

运行jupyter --version得到以下输出：

IPython          : 8.30.0
ipykernel        : 6.29.5
ipywidgets       : 7.7.2
jupyter_client   : 8.6.3
jupyter_core     : 5.7.2
jupyter_server   : 2.14.1
jupyterlab       : 4.3.4
nbclient         : 0.8.0
nbconvert        : 7.16.4
nbformat         : 5.10.4
notebook         : 7.3.2
qtconsole        : 5.6.1
traitlets        : 5.14.3

2. JupyterLab扩展列表

运行jupyter labextension list得到以下输出：

JupyterLab v4.3.4  
JupyterLab v4.3.4
/home/username/.conda/envs/test_venv/share/jupyter/labextensions
        jupyterlab-plotly v5.24.1 enabled  X
        @lckr/jupyterlab_variableinspector v3.1.0 enabled OK (python, lckr_jupyterlab_variableinspector)
        @pyviz/jupyterlab_pyviz v3.0.2 enabled OK
        @jupyter-notebook/lab-extension v7.3.2 enabled OK
        @jupyter-widgets/jupyterlab-manager v3.0.0 enabled  X (python, jupyterlab_widgets)


   The following extensions may be outdated or specify dependencies that are incompatible with the current version of jupyterlab:
        jupyterlab-plotly
        @jupyter-widgets/jupyterlab-manager
        
   If you are a user, check if an update is available for these packages.
   If you are a developer, re-run with `--verbose` flag for more details.

Other labextensions (built into JupyterLab)
   app dir: /home/username/.conda/envs/test_venv/share/jupyter/lab
        @jupyterlab/plotly-extension v1.0.0 enabled  X

   The following extensions may be outdated or specify dependencies that are incompatible with the current version of jupyterlab:
        @jupyterlab/plotly-extension
        
   If you are a user, check if an update is available for these packages.
   If you are a developer, re-run with `--verbose` flag for more details.

求助问题

我该如何解决这个问题，让ipywidgets能在JupyterLab和Jupyter Notebook中正常显示？是否需要重装或更新特定的扩展？

专家解答

问题根源分析

从你提供的环境信息和扩展列表来看，核心问题是版本兼容性不匹配：

你当前使用的ipywidgets 7.7.2是旧版本，对JupyterLab 4.x的支持不足，JupyterLab 4.x需要ipywidgets 8.x系列版本才能完美适配；
@jupyter-widgets/jupyterlab-manager扩展被标记为X，说明该扩展与当前JupyterLab 4.3.4的依赖不兼容，无法正常加载，这直接导致了widget无法显示的报错。

分步解决方案

1. 更新ipywidgets及对应扩展到兼容版本

激活你的conda环境test_venv后，执行以下命令更新依赖：

# 使用pip更新（推荐）
pip install --upgrade ipywidgets jupyterlab_widgets

# 若使用conda环境，可执行：
# conda install -c conda-forge ipywidgets=8 jupyterlab_widgets

这条命令会将ipywidgets升级到支持JupyterLab 4.x的8.x版本，同时安装/更新对应的jupyterlab_widgets扩展，确保二者版本匹配。

2. 重建JupyterLab扩展缓存

更新完成后，需要重建JupyterLab的扩展缓存，确保新扩展正确集成：

jupyter lab build

3. 重启JupyterLab/Notebook

关闭当前运行的JupyterLab或Notebook实例，重新启动后，运行你的最小示例代码进行测试：

import ipywidgets as widgets
from IPython.display import display
slider = widgets.IntSlider(min=0, max=100)  
display(slider)

可选：修复Plotly扩展兼容性问题

从扩展列表看，plotly相关扩展也标记了X，如果后续需要使用plotly可视化，可一并更新：

pip install --upgrade plotly jupyterlab-plotly
jupyter lab build

验证方法

完成上述步骤后，再次运行jupyter labextension list，确认@jupyter-widgets/jupyterlab-manager显示enabled OK（无X标记），此时ipywidgets应该能正常显示。

备注：内容来源于stack exchange，提问作者CodingQuestions