jupyterlab是唯一稳定支持左侧文件浏览器的方案,因其默认集成file browser且与编辑区解耦;而notebook v7+架构不支持常驻文件树,所有旧插件方案均失效。

jupyter_contrib_nbextensions 在 Notebook v7+ 上已失效,直接安装会报 ModuleNotFoundError: No module named 'notebook.nbextensions'。别折腾旧插件了,该换方案。
确认你用的是 notebook 还是 jupyterlab
先看地址栏:
- 如果是 http://localhost:8888/tree 或 http://localhost:8888/notebooks/xxx.ipynb → 你用的是经典 notebook(v7.3.2 及以上)
- 如果是 http://localhost:8888/lab → 你用的是 jupyterlab
两者侧边栏机制完全不同,混用方案必失败。
notebook v7+ 没有真正意义上的左侧文件目录栏
经典 notebook 的架构不支持常驻文件浏览器。它只有两个视图:/tree(纯文件列表)和 /notebooks/xxx.ipynb(单文件编辑),二者互斥。
所以:
- 你无法在编辑 .ipynb 时同时看到左侧文件树
- 所有声称“启用插件后左侧出现目录”的教程,基本都基于 v6.x 及更早版本,对当前环境无效
- 即使强行降级 notebook,也会引发 jupyter_server 兼容问题,得不偿失
jupyterlab 是唯一稳定支持左侧文件浏览器的方案
jupyterlab 默认就带左侧 File Browser,且与编辑区完全解耦:
- 启动命令不是 jupyter notebook,而是 jupyter lab
- 文件拖入编辑区自动以 notebook / text / markdown 多视图打开
- 支持 Ctrl+Shift+F 全局搜索文件,右键可新建、重命名、删除
- 不需要任何额外插件,也不依赖 jupyter_contrib_nbextensions
如果你已装过 jupyterlab(查 jupyter --version 看 jupyterlab 行),直接运行 jupyter lab 即可。没装就:
- pip install jupyterlab(推荐)或 conda install -c conda-forge jupyterlab
- 注意:不要运行 jupyter labextension install —— 这个命令在 v4+ 已弃用
实在不能换 jupyterlab?只能妥协用临时方案
在经典 notebook 中,能做的只有两件事:
- 快速切换:按 Esc + T(注意是大写 T)跳转到 /tree 页面,浏览文件后点回 notebook
- 目录生成(非文件导航):装 toc2 插件(仅限 v6.x)或改用 nbconvert 导出 HTML 后查看目录 —— 但它只解析 Markdown 标题,不列文件
- 浏览器分屏:开两个标签页,一个 /tree,一个 /notebooks/xxx.ipynb,手动同步
这些都不是“侧边栏”,只是权宜之计。真正的左侧文件目录,只存在于 jupyterlab 的设计里,不是靠 patch 能补出来的。











