sidebarfolders 插件不存在,sublime text 原生 project 机制通过 project → add folder to project… 支持多文件夹并存,需保存 .sublime-project 文件且推荐使用相对路径。

SidebarFolders 插件根本不存在,别装了
Sublime Text 官方包控制(Package Control)里没有叫 SidebarFolders 的插件,也没任何主流社区维护该项目。你搜到的教程大概率是混淆了插件名,或把某个已废弃、重命名、仅适配旧版 Sublime 的小众脚本当成了通用方案。强行下载非官方源的 zip 或 clone 仓库,极可能触发 ImportError、AttributeError: 'module' object has no attribute '...' ,甚至导致侧边栏完全不渲染。
真正能实现“跨项目目录并存”的只有原生 Project 机制
Sublime Text 原生就支持一个窗口加载多个不相关文件夹,靠的是 Project → Add Folder to Project…,不是靠插件。这个操作会把路径写进当前项目的 .sublime-project 文件的 "folders" 数组里——这才是可靠、可版本控制、重启不失效的方案。
- 必须先打开至少一个文件夹(
File → Open Folder…),再执行Project → Add Folder to Project…,否则菜单项是灰色的 - 添加完每个文件夹后,务必点一次
Project → Save Project(注意不是Save Project As…),否则改动只存在内存里,关窗就丢 -
"path"推荐用相对路径,比如"."或"backend",避免硬编码"C:/dev/myapp/backend"导致换机器失效 - 想在侧边栏给长路径起个短名字?加
"name": "API"字段就行,它只影响显示,不影响实际路径解析
为什么有人误信 SidebarFolders?其实是把 SideBarEnhancements 当成目录管理器了
SideBarEnhancements 是真实存在的插件,但它只增强右键菜单(比如“在资源管理器中打开”“复制路径”),**不改变项目结构、不支持多文件夹自动加载、也不干预 .sublime-project 的读写逻辑**。装了它,Project → Add Folder to Project… 还得手动点,只是右键多了几项快捷操作而已。
- 如果你看到教程说“装完 SidebarFolders 就能自动同步所有项目目录”,那是在混淆概念——Sublime 没有全局目录索引,每个窗口的侧边栏内容完全由当前加载的
.sublime-project决定 -
SideBarEnhancements的sidebar_folder_path配置项只控制右键菜单行为,和项目加载无关 - 真要模糊搜索跨多个项目?用
Ctrl+P(Goto Anything)——它默认搜当前项目所有"folders",不需要额外插件
切换多个独立项目时,别依赖 Project → Switch Project
Project → Switch Project 调用的是 Sublime 内置的历史列表,但这个列表只记录你曾经用 Project → Open Project 打开过的 .sublime-project 文件路径。如果某次你是双击文件打开的,或者用命令行 subl myproj.sublime-project 启动的,它大概率不会出现在 Switch 列表里,点开直接报错 Unable to open project: path does not exist。
- 最稳的方式:把所有
.sublime-project文件统一放在一个文件夹里(比如~/projects/),然后用Ctrl+Alt+P(Windows/Linux)或Cmd+Option+P(macOS)唤出项目面板,输入文件名前缀就能跳转 - 确保每个项目都保存过:没执行过
Project → Save Project As…的窗口,关掉就等于没项目,Switch Project列表里永远找不到它 -
.sublime-workspace文件不要提交 Git,它存的是你个人的标签页状态;但.sublime-project必须提交,它是项目定义本身
"folders" 就变成空数组;路径写成绝对路径,同事拉代码后侧边栏直接空白——这些不是边缘情况,是每天都在发生的事实。











