根本原因是漏掉jupyter contrib nbextension install --user和jupyter nbextension enable --py jupyter_nbextensions_configurator --user两步，仅pip/conda安装无法部署前端资源与注册菜单，需按顺序执行安装、install、enable、重启四步，并注意Windows管理员权限及禁用兼容性限制。
为什么装了包却看不到 Nbextensions 选项卡
根本原因不是没装对包，而是漏掉了两个关键动作：jupyter contrib nbextension install --user 和 jupyter nbextension enable --py jupyter_nbextensions_configurator --user。只用 pip install 或 conda install 装包，只是把 Python 模块放进环境里，但插件的前端资源（JS/CSS）没复制到 Jupyter 可识别路径，配置菜单也没注册进界面。
常见错误现象：
- 打开 Jupyter 后顶部菜单没有
Nbextensions标签 - 命令行显示 “Successfully installed”，但刷新页面依旧空白
- 在 Anaconda Prompt 里执行命令没报错，却始终找不到入口
必须按顺序做四件事：
-
pip install jupyter_contrib_nbextensions jupyter_nbextensions_configurator（或 conda 对应命令） -
jupyter contrib nbextension install --user—— 把 JS/CSS 文件写入用户级静态目录 -
jupyter nbextension enable --py jupyter_nbextensions_configurator --user—— 注册菜单项 - 重启 Jupyter Notebook 进程（不是仅刷新网页）
Windows 用户用 Anaconda Prompt 必须以管理员身份运行
否则 --user 参数会因权限不足写入失败，尤其是 jupyter contrib nbextension install --user 这一步，可能静默跳过文件复制，导致后续所有插件图标不显示。
典型表现：
- 命令行输出
[I ...] Installing ...看似成功，但~/.jupyter/nbextensions/目录下为空或缺失jupyter_contrib_nbextensions子目录 - 检查路径：
dir %USERPROFILE%\.jupyter\nbextensions（Windows）或ls ~/.jupyter/nbextensions（macOS/Linux） - 如果该目录不存在或内容为空，说明 install 步骤未真正生效
解决办法：右键「Anaconda Prompt」→「以管理员身份运行」再重试 install 命令。
启动后必须关闭兼容性限制才能启用主流插件
即使 Nbextensions 选项卡出现了，Table of Contents、Variable Inspector、Code folding 这些插件默认是灰色不可勾选的——因为 Jupyter 默认开启 Disable configuration for nbextensions without explicit compatibility，它会屏蔽所有未在元数据中声明支持当前 Notebook 版本的扩展。
这不是 bug，是安全策略，但绝大多数活跃插件（包括 Table of Contents (2)）都未更新兼容性声明，所以你得手动关掉这个开关：
- 打开 Jupyter Notebook → 点击顶部
Nbextensions标签页 - 取消勾选最上方那项
Disable configuration for nbextensions without explicit compatibility - 刷新页面或重新打开一个 notebook，插件列表立刻变亮可选
注意：这个设置是全局生效的，关一次就行，不用每次开 notebook 都操作。
清华源加速安装能绕过超时和下载失败
jupyter_contrib_nbextensions 包体积大（约 20MB），默认 PyPI 源在国内常超时或中断，直接 pip install jupyter_contrib_nbextensions 容易卡住或报 ConnectionError。
推荐用国内镜像源一步到位：
pip install jupyter_contrib_nbextensions -i https://pypi.tuna.tsinghua.edu.cn/simplepip install jupyter_nbextensions_configurator -i https://pypi.tuna.tsinghua.edu.cn/simple
不需要改 pip 全局源，临时加 -i 参数即可。装完再执行 install 和 enable 命令，整个流程基本不会卡在下载环节。
真正容易被忽略的是：插件启用后，Table of Contents 只对已运行过的 Markdown 标题单元格生效——也就是说，你写了 # Introduction，但没按 Ctrl+Enter 或点击运行按钮，目录里就不会出现这一项。
