侧边栏为空不是Bug,是Sublime设计使然:未通过“Open Folder”添加文件夹或配置project为null时侧边栏默认为空;需显式添加文件夹、保存.sublime-project文件并安装SideBarEnhancements插件才能正常使用。

侧边栏为空不是Bug,是没加载文件夹
Sublime 的侧边栏根本就不是“面板”,它本质是项目文件树视图。只打开单个 .py 或 index.html 文件时,侧边栏默认就是空的——这不是故障,是设计使然。它不猜路径、不自动挂载父目录,必须显式告诉它“这是我的根”。
常见错误现象:Ctrl+K Ctrl+B 按了没反应,或按了后侧边栏一闪就空着;右键只有 Reveal in Side Bar 和 Open Containing Folder,没有 New File。
- 确认你用的是
File → Open Folder…(Windows/Linux)或File → Open…并选中整个文件夹(macOS),而不是Open File - 检查用户设置里有没有误加
"project": null—— 这行会清空全部项目上下文,侧边栏必然为空 - 便携版用户注意:
subl .命令失效时,Add Folder to Project也可能无响应,本质是路径注册失败
添加多个文件夹到同一侧边栏,靠 Add Folder to Project
一个 Sublime 窗口可以同时管理多个不相关的代码库,比如 backend、frontend、docs,全堆在侧边栏里,各自独立展开。关键不是“打开多个窗口”,而是“往同一个项目里加多个根”。
使用场景:Java 多模块项目、前后端分离开发、文档与源码共管。
- 菜单操作:
Project → Add Folder to Project,选中目标文件夹,重复即可 - 快捷方式:直接把文件夹拖进侧边栏空白区(不是编辑区),松手即生效
- 路径写法要干净:Windows 写
C:\myproject,macOS/Linux 写/Users/me/myproject,结尾不加/,否则 Sublime 可能识别失败 - 右键侧边栏里的任一文件夹 →
Remove Folder from Project,仅从当前项目移除,不删磁盘文件;但新手常误点系统级Delete,结果真删了
不保存 .sublime-project,关掉再开就全没了
临时添加的文件夹不会跨会话保留。退出 Sublime 后重开,侧边栏变空,不是软件崩溃,是你没固化配置。持久化唯一可靠方式是生成 .sublime-project 文件。
性能影响:未排除 node_modules 或 .git 目录时,大项目会导致侧边栏卡顿、搜索变慢。
- 加完所有文件夹后,立刻执行
Project → Save Project As…,存为myapp.sublime-project - 该文件是 JSON 格式,含
"folders"字段,路径是相对该文件本身的,不是相对 Sublime 安装目录 - 在用户设置中加这两项:
"remember_open_files": true和"hot_exit": true,并确保正常退出 Sublime(别强杀进程) - 大目录优化:在
.sublime-project的"folders"下为每个路径配"folder_exclude_patterns",例如["node_modules", ".git"]
右键没 New File?缺 SideBarEnhancements 插件
原生 Sublime 侧边栏右键只有两个选项,不支持新建文件/文件夹。这不是隐藏功能,是设计如此。想用右键新建,必须装插件,且安装方式很关键。
容易踩的坑:手动解压 ZIP 到 Packages/ 目录会导致签名校验失败,插件彻底不加载;改了插件 Settings 里的任意字段,90% 情况下 New File 按钮会消失。
- 必须通过命令面板安装:
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索SideBarEnhancements(注意拼写,不是SidebarEnhancement,也不带下划线) - 插件生效硬性前提:目标文件夹必须已通过
Project → Add Folder to Project…显式加入项目;直接拖进窗口的文件夹不算 - Windows 用户若路径在
C:\Program Files\或受控文件夹下,系统会静默拒绝写入,New File点击后弹窗一闪即逝 - 别碰
Preferences → Package Settings → SideBarEnhancements → Settings—— 默认配置最稳,自定义反而容易崩
真正麻烦的从来不是“怎么加”,而是“加完要不要删”“删了会不会丢代码”“下次打开还在不在”。项目结构一旦复杂,.sublime-project 文件就成了事实上的项目入口,而不是可有可无的配置附件。

















