求助：Jupyter nbextension toc2工具栏被遮挡，无法显示‘contents’

问题现象 #

• 在Safari浏览器中使用Jupyter的toc2扩展时，无法查看完整目录
• 当前使用对应版本的nbextension（对应原版本信息截图内容）

已尝试操作 #

• 更换过nbextension版本
• 尝试修改笔记本元数据（参考过相关方案）

针对性解决步骤 #

1. Safari浏览器兼容性调整

   • 关闭「阻止跨站跟踪」：打开Safari偏好设置→隐私→取消勾选「阻止跨站跟踪」
   • 清空浏览器缓存：使用快捷键Command+Option+E清空缓存，重启Safari后重新打开Jupyter Notebook
   • 开启开发者模式禁用缓存：偏好设置→高级→勾选「在菜单栏中显示“开发”菜单」，然后在开发菜单中选择「禁用缓存」

2. toc2扩展配置重置

   • 在Jupyter的nbextensions页面，找到toc2扩展，先点击「Disable」禁用，再重新「Enable」
   • 进入扩展的「Configure」界面，确保勾选以下关键选项：
     • Expand all headings（展开所有标题）
     • Number sections（章节编号，辅助确认目录完整性）
   • 保存配置后关闭并重新打开笔记本

3. 笔记本元数据修正
   打开笔记本的「编辑→编辑笔记本元数据」，确保toc字段配置正确，示例如下：

   {
     "toc": {
       "nav_menu": true,
       "sideBar": true,
       "toc_section_display": true,
       "toc_position": {
         "width": "280px",
         "height": "calc(100% - 120px)"
       }
     }
   }
   

   修改完成后点击「保存」，重启笔记本查看效果

4. 版本兼容性排查与更新

   • 运行以下命令更新核心组件，确保版本匹配：

     pip install --upgrade jupyter notebook
     pip install --upgrade jupyter_contrib_nbextensions
     jupyter contrib nbextension install --user
     

   • 若使用JupyterLab（非经典Notebook），需安装对应扩展：

     jupyter labextension install @jupyterlab/toc
     

内容的提问来源于stack exchange，提问作者趙世翔Shih-Hsiang Chao