使用keras-tqdm时Jupyter Widget HBox显示失败求助

开发者阿泽

2026-5-15

踩过这个坑的过来人给你几个靠谱的解决方向，一步步来排查：

先确认ipywidgets扩展是否正确启用
很多时候conda安装完ipywidgets只是装了包，但没启用Notebook扩展。在你的py36环境终端里运行：
```
jupyter nbextension enable --py widgetsnbextension
```
运行完后完全关闭所有Jupyter窗口，重新启动Notebook再测试。
检查版本兼容性，重装适配的依赖包
keras-tqdm、tqdm和ipywidgets的版本不匹配是常见问题。先卸载现有版本：
```
pip uninstall keras-tqdm tqdm -y
```
然后安装和ipywidgets 7.1.1兼容的版本（亲测tqdm 4.36.1和这个版本配合很稳定）：
```
pip install keras-tqdm tqdm==4.36.1
```
清理Jupyter缓存，消除旧JS残留
之前更新过JavaScript组件，可能有缓存冲突。关闭所有Jupyter窗口后：
- Windows用户删除%APPDATA%\jupyter\nbextensions下的widgets相关文件夹
- Linux/macOS用户删除~/.local/share/jupyter/nbextensions下的widgets相关文件夹
  删完后重新启动Jupyter，再尝试运行模型训练代码。
更新Jupyter Notebook到兼容版本
过旧的Notebook版本也会和ipywidgets 7.x不兼容。在终端运行：
```
conda update notebook
```
把Notebook更新到5.7以上的版本，重启后再测试。
先测试基础Widget是否能正常显示
排除keras-tqdm本身的问题，在Notebook里运行这段简单代码：
```
from ipywidgets import HBox, IntSlider
HBox([IntSlider(), IntSlider()])
```
如果这段代码也显示不了HBox Widget，那问题出在ipywidgets本身。可以尝试彻底重装ipywidgets：
```
conda uninstall ipywidgets -y
conda install -c conda-forge ipywidgets=7.1.1
```
重装后再执行第一步的启用扩展命令。