jupyter nbextension list 是最可靠的插件状态验证方式,因为它直接读取 jupyter 实际加载的前端扩展配置(nbextensions 目录文件 + notebook.json 启用记录),不依赖图形界面渲染,输出分 known/enabled/disabled 三类状态,可精准定位安装或启用缺失问题。

直接运行 jupyter nbextension list 即可列出所有已安装且启用/禁用状态的插件,无需打开网页界面。
为什么 jupyter nbextension list 是最可靠的方式
它读取的是 Jupyter 实际加载的前端扩展配置(nbextensions 目录下的 JS/CSS 文件 + notebook.json 中的启用记录),不依赖图形界面是否渲染成功,也不受“Disable configuration for nbextensions without explicit compatibility”勾选状态影响。
- 输出分三块:
Known extensions(已安装但未启用)、Enabled extensions(当前生效)、Disabled extensions(装了但被手动关掉) - 若某插件出现在
Known extensions但没进Enabled,说明你漏了jupyter nbextension enable步骤 - 若整个输出为空,大概率是
jupyter contrib nbextension install --user没执行,或执行时权限失败(尤其 Windows 下未用管理员 Anaconda Prompt)
jupyter nbextension list 报错或显示混乱怎么办
常见错误如 JSONDecodeError、输出里出现乱码路径、或某行末尾多出逗号导致解析失败,基本都指向配置文件损坏。
- 先查配置目录位置:
jupyter --config-dir,然后进入该目录下的nbconfig/notebook.json - 用文本编辑器打开
notebook.json,检查是否有非法字符、多余逗号、中文引号、或手动写错的插件名(比如把codefolding写成code_folding) - 删掉疑似错误的整段条目,保存后重试
jupyter nbextension list - 别手抖留空行或末尾逗号——JSON 不认这个
图形界面打不开时,jupyter nbextension list 就是唯一真相
很多用户卡在“Nbextensions 标签页不出现”,其实不是插件没装,而是 jupyter_nbextensions_configurator 没启用,或 Jupyter 版本太高(≥7.0)与旧版 configurator 不兼容。这时候图形界面可能空白或 404,但插件本身只要装进去了,jupyter nbextension list 一定能看到。
- 如果
jupyter nbextension list能看到插件,只是网页不显示菜单,可以跳过 configurator,直接命令行启用:jupyter nbextension enable --py --sys-prefix codefolding - 注意:插件名要严格匹配
jupyter nbextension list输出里的 key,比如toc2不是table-of-contents - 启用后刷新 notebook 页面,功能就生效,不用重启服务
真正容易被忽略的是:插件是否被正确复制到 Jupyter 可识别路径(靠 install 命令),和是否被写入启用清单(靠 enable 命令)——这两步缺一不可,而 jupyter nbextension list 是唯一能同时验证两者状态的命令。











