有两步不能省：先执行 jupyter contrib nbextension install --user，再执行 jupyter nbextension enable --py jupyter_nbextensions_configurator --user。不然页面里看不到 Nbextensions 这个选项卡。

另外，启用之后还得把兼容性限制关掉。这样目录导航、代码折叠这类功能才能正常用起来。

装完 jupyter_contrib_nbextensions 和 jupyter_nbextensions_configurator 两个包后，若不执行 install 和 enable 命令，Nbextensions 标签页根本不会出现。这是 90% 安装失败的根源。

为什么 Nbextensions 选项卡不显示？

问题通常不是没装对包，而是没把插件前端文件复制进 Jupyter 可识别路径，也没启用配置器菜单。

只执行 pip/conda install 是无效的。

• jupyter contrib nbextension install --user：把 JS/CSS 文件复制到用户级 nbextensions 目录。跳过这步，界面连图标都不会加载。
• jupyter nbextension enable --py jupyter_nbextensions_configurator --user：让 Jupyter 在启动时加载配置器模块。否则顶部菜单栏永远没有 “Nbextensions”。
• Windows 用户若用 Anaconda Prompt，建议右键“以管理员身份运行”，避免 --user 因权限不足写入失败。

Hinterland 补全插件点不了？

关掉兼容性限制

即使 Nbextensions 标签页出来了，Hinterland、Table of Contents (2)、Variable Inspector 这些主流插件默认也可能灰显不可勾选。

原因是 Jupyter 启用了严格兼容性检查。

• 打开 Jupyter Notebook，点击顶部 Nbextensions 标签页。
• 取消勾选 Disable configuration for nbextensions without explicit compatibility。
• 这个选项默认开启，会屏蔽所有未在元信息里声明支持当前 Jupyter 版本的插件（包括 Hinterland）。
• 关掉它之后，再勾选 Hinterland，立刻生效，无需重启 notebook。

conda 和 pip 安装路径不能混用

同一环境中混用 conda 和 pip 安装 nbextensions 相关包，容易引发依赖冲突或路径错位，导致插件加载失败。

• conda 用户统一走 conda-forge：conda install -c conda-forge jupyter_contrib_nbextensions jupyter_nbextensions_configurator
• pip 用户全程加 --user：pip install --user jupyter_contrib_nbextensions jupyter_nbextensions_configurator
• 安装后命令必须匹配环境：conda 环境下用 --sys-prefix，非 conda 环境（如 venv）必须用 --user。
• 执行 jupyter contrib nbextension install 前，确认当前终端已激活目标环境（提示符前有 (env_name)）。

补全功能没生效，先排查这两个细节

很多人最容易漏掉的，其实是这个细节：插件启用之后，补全功能并不是立刻对所有 notebook 一并生效。

它只会作用于新打开的 notebook。已经打开的 notebook，需要手动刷新页面，或者重新运行 kernel，Hinterland 的 Tab 提示才会正常触发。

还有一点也很关键，补全建议本质上依赖 kernel 返回的 completion 数据。

一旦 kernel 没有响应，比如卡住了，或者压根还没启动，Hinterland 就不会弹出任何提示。

这种情况下，先看看右上角的 kernel 状态，别一上来就急着重装插件。

《夸克》非常好用的免费AI浏览器

下载APP查看