必须装全jupyter_contrib_nbextensions和jupyter_nbextensions_configurator两个包,执行install和enable命令,并关闭兼容性限制开关,三步缺一不可。

装不上 Nbextensions 选项卡,不是命令少敲了,而是两个包没装全、两步 install 和 enable 没跑对,或者兼容性开关还关着——这三类问题占了安装失败的 90% 以上。
必须装的两个包:jupyter_contrib_nbextensions 和 jupyter_nbextensions_configurator
它们分工明确,缺一不可:
-
jupyter_contrib_nbextensions是插件本体,含所有功能(如Table of Contents (2)、Code folding),不装它,后面全是空谈 -
jupyter_nbextensions_configurator是控制面板,负责在 Jupyter 顶部生成Nbextensions标签页,不装它,你根本看不到开关界面 - 用 conda 安装更稳:先运行
conda install -c conda-forge jupyter_contrib_nbextensions,再运行conda install -c conda-forge jupyter_nbextensions_configurator - 用 pip 的话,注意加清华源提速:
pip install jupyter_contrib_nbextensions -i https://pypi.tuna.tsinghua.edu.cn/simple
install 和 enable 命令不能跳,且参数要匹配环境
装完包只是把 Python 模块放进环境,JS/CSS 文件还没复制到 Jupyter 能读取的位置,菜单也没注册进前端。这两步漏一个,Nbextensions 标签页就永远不会出现:
- 执行
jupyter contrib nbextension install --user:把插件静态资源复制到用户级路径,Windows 用户若提示权限错误,需用管理员身份开 Anaconda Prompt - 执行
jupyter nbextension enable --py jupyter_nbextensions_configurator --user:启用配置器后端,让标签页能加载;如果用 conda 环境,有时得换--sys-prefix替代--user - Docker 或某些受限环境可能报 “notebook not running” 错,加
--skip-running-check参数绕过检查
启动后必关这个开关:Disable configuration for nbextensions without explicit compatibility
这是最常被忽略的一步。Jupyter Notebook 新版本默认开启该限制,会直接屏蔽所有未声明兼容性的插件——而 Table of Contents (2)、Variable Inspector、Code folding 全部中招,灰显不可勾选:
- 启动 Jupyter Notebook,点顶部
Nbextensions标签页 - 找到并取消勾选
Disable configuration for nbextensions without explicit compatibility - 此时插件列表才真正“活”起来,勾选任意功能(比如
Table of Contents (2))后立即生效,无需重启 - 如果勾选后仍无反应,检查浏览器控制台是否有
403错误——大概率是jupyter-server版本太高(如 2.10+),需降级到jupyter-server==1.13.4
真正卡住人的从来不是命令记不住,而是 install 和 enable 混用 --user/--sys-prefix 导致路径错位,或兼容性开关没关导致插件集体失能。做完这三件事,Nbextensions 就稳了。


















