如何解决或调试IPyWidgets仅部分显示的问题？

步骤1：检查版本兼容性 #

激活你的venv环境后，先确认ipywidgets与Jupyter版本匹配：

pip list | grep -E "ipywidgets|jupyter|notebook"

• 若使用Notebook 7.x及以上版本，需保证ipywidgets≥8.0.0
• 若使用Notebook 6.x版本，ipywidgets 7.x系列兼容性更好

版本不匹配时，卸载重装对应版本：

pip uninstall -y ipywidgets
# 适配Notebook 7+用这个
pip install ipywidgets==8.0.6
# 适配Notebook 6用这个
# pip install ipywidgets==7.7.5

步骤2：重新安装前端扩展 #

venv环境下常出现前端扩展未正确部署的情况，执行以下命令：

# 针对Notebook
jupyter nbextension enable --py widgetsnbextension --sys-prefix
# 针对Jupyter Lab（需先安装node.js：brew install node）
jupyter labextension install @jupyter-widgets/jupyterlab-manager

步骤3：验证扩展状态 #

执行命令检查扩展是否启用：

jupyter nbextension list

正常输出应包含：

• jupyter-js-widgets/extension enabled
  • Validating: OK

若显示disabled或未找到，重新执行步骤2的enable命令。

步骤4：重置环境并清理缓存 #

• 完全关闭所有Jupyter窗口和终端进程，重新启动服务
• 强制清空浏览器缓存（Chrome：Cmd+Shift+R；Safari：Cmd+Option+R），避免旧资源干扰

步骤5：纯净环境测试 #

如果问题仍存在，创建全新venv环境从头部署，排除环境污染：

python -m venv clean_venv
source clean_venv/bin/activate
pip install notebook ipywidgets
jupyter nbextension enable --py widgetsnbextension --sys-prefix
jupyter notebook

在新环境中运行测试代码，观察控件是否正常显示。

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