jupyter_contrib_nbextensions在notebook v7+中失效，因其依赖的notebook.nbextensions模块已被移除，新版需使用内置toc扩展：启动后按ctrl+shift+p输入toc启用目录侧边栏，确保notebook≥7.3且未禁用nbserver_extensions。
jupyter_contrib_nbextensions 在 notebook v7+ 上已失效，直接装它会报 ModuleNotFoundError: No module named 'notebook.nbextensions'。新版（2026 年主流环境：notebook ≥7.3，jupyterlab ≥4.3）必须换用官方支持的替代方案。
为什么 jupyter_contrib_nbextensions 不能用了
这个包依赖旧版 notebook 的内部模块路径，而 v7 起重构了扩展机制，移除了 notebook.nbextensions。即使强行降级 notebook，也会破坏 jupyter_server 和 jupyterlab 的兼容性，引发内核断连、保存失败、TOC 不刷新等问题。
新版 notebook（v7.3+）显示目录的正确方式
目前唯一稳定、无副作用的方式是启用内置的 toc 扩展（Jupyter Server 自带，无需额外 pip install）：
- 确保你用的是 notebook ≥7.3（运行
jupyter --version确认） - 启动 notebook 后，在任意 .ipynb 文件中，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
toc，选择Toggle Table of Contents Sidebar - 侧边栏会立刻出现目录，自动识别
#~######标题，支持点击跳转 - 该 sidebar 是响应式的，拖动边缘可调整宽度；关闭后下次仍可通过命令面板唤出
如果命令面板里搜不到 toc 选项
说明你的 notebook 版本虽新，但未启用 toc 插件（极少数精简安装场景）：
- 检查配置文件是否存在：
~/.jupyter/jupyter_notebook_config.py - 若不存在，运行
jupyter notebook --generate-config创建 - 在该文件末尾添加一行：
c.NotebookApp.nbserver_extensions = {'jupyter_server_mathjax': True}（无需改这行）——真正要加的是：c.NotebookApp.contents_manager_class = 'jupyter_server.services.contents.filemanager.FileContentsManager'（默认已有） - 实际只需确认：该配置文件里没有禁用 toc，即没有
c.NotebookApp.nbserver_extensions = {}或显式设为False - 更稳妥做法：删掉整个
nbserver_extensions配置项，让 notebook 使用默认启用列表
别再折腾 toc2 或 Collapsible Headings
这些是 jupyter_contrib_nbextensions 里的子插件，现在全不可用。试图用 conda/pip 强装它们，只会导致：
-
jupyter notebook启动失败，报错含ImportError: cannot import name 'get_nbextension_metadata' - 即使启动成功，目录按钮点击无反应，或标题不渲染进 TOC
- 保存时卡住，浏览器控制台报
Failed to load resource: net::ERR_CONNECTION_REFUSED - 与
jupyterlab_widgets冲突，导致交互控件（如 slider）失效
真正的目录功能就藏在命令面板里，不是靠勾选 Nbextensions 页面——那个页面在 notebook v7+ 中本身已降级为只读状态，多数插件开关灰显不可点。
