Sublime Text 的 Project 是基于 .sublime-project 文件的静态工作区配置,一个窗口仅能加载一个 Project;需手动保存、通过菜单或 Project Manager 插件切换,不支持 VS Code 式多项目自由切换。

Sublime Text 的 Project 不是“多窗口项目”,而是独立配置文件
很多人以为 Sublime 支持像 VS Code 那样在单个窗口里自由切换多个项目,其实不是。Sublime 的 Project 是基于 .sublime-project 文件的静态工作区定义——它保存了文件夹路径、设置、构建系统、折叠状态等,但**一个窗口只能加载一个 Project**。想“管理多个项目”,本质是快速保存、加载、切换这些 .sublime-project 文件。
怎么保存当前工作区为 .sublime-project
必须手动触发保存,Sublime 不会自动为你建 Project 文件。常见错误是只用 File → Open Folder...,结果关掉后所有设置(比如排除的文件、侧边栏展开状态)全丢了。
- 打开目标文件夹后,点击
Project → Save Project As...,选好路径并命名为xxx.sublime-project(建议放在项目根目录) - 保存后,Sublime 会自动生成 JSON 内容,包含
"folders"字段;你可以后续手动编辑它来添加"excluded_folders"或"settings" - 别把
.sublime-project放在 Sublime 安装目录或Packages/下——它必须和你管理的文件夹逻辑相关,否则路径解析会出错
切换 Project 的两种可靠方式
没有快捷键一键轮换,得靠菜单或命令面板。容易踩的坑是误点 Switch Project(那是跳转到最近打开的文件夹,不是 Project 文件)。
-
Project → Open Project...:直接选择已有的.sublime-project文件,会关闭当前 Project 并加载新的 -
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)→ 输入Project: Switch Project:这个命令列出的是「最近通过Open Project加载过的 .sublime-project 文件」,不是所有磁盘上的 Project - 如果想快速访问常用 Project,可以把它们的
.sublime-project文件放在固定目录,然后用Project → Add Folder to Project...临时组合,但这不等于真正切换 Project
用 Project Manager 插件简化操作(推荐)
原生功能太简陋,Project Manager 是社区最稳定的扩展,它把 Project 当作可索引、可搜索、可分组的一等公民。
- 安装后,
Ctrl+Shift+P输入Project Manager: Save Project即可保存当前窗口为 Project(自动命名 + 存到默认目录) -
Project Manager: Quick Switch Project调出模糊搜索列表,支持中文、路径关键词、最近使用排序 - 它的 Project 数据默认存在
Packages/User/Projects/下,不污染你的源码目录;也可以在插件设置里指定自定义路径 - 注意:启用该插件后,原生的
Switch Project命令就基本不用了——它只读取 Sublime 自己的缓存,而Project Manager维护的是完整清单
{
"folders":
[
{
"path": "/Users/me/workspace/my-api",
"folder_exclude_patterns": ["node_modules", ".git"]
}
],
"settings":
{
"tab_size": 2,
"translate_tabs_to_spaces": true
}
}
Project 的真正复杂点不在创建,而在维护:比如团队协作时要不要提交 .sublime-project?答案取决于是否包含机器相关路径或敏感设置。多数情况建议忽略它,或只提交不含 "path" 的模板版本。










