sublime text 的项目管理基于单一 .sublime-project 文件绑定整个窗口,不支持多项目叠加;需手动保存项目、正确配置路径与 settings,并依赖 .sublime-workspace 保存会话状态。

一个窗口只能加载一个 .sublime-project,别指望像 VS Code 那样自由叠加
Sublime 的项目(Project)本质是静态配置文件,不是运行时工作区。你点开一个 .sublime-project,它就接管整个窗口——所有侧边栏内容、打开的标签页、折叠状态、甚至光标位置,都属于这个项目。这不是限制,而是设计:它靠 .sublime-workspace 文件存会话状态,靠 JSON 配置做隔离。
- 想同时看两个项目?只能开两个 Sublime 窗口,各自加载一个
.sublime-project - 误以为“Add Folder to Project”等于切换项目?错。这只是把另一个目录挂进当前项目,它仍属于同一个
.sublime-project,设置、构建系统、折叠状态全共享 - 把
.sublime-project放在 Sublime 安装目录或Packages/下?路径解析会失效,侧边栏可能空白或报错 “folder not found”
保存项目不是自动的,不手动点 Save Project As… 就没有项目
很多人切不到项目,根本原因是压根没真正保存过。Sublime 不会因为你打开了某个文件夹就自动生成项目文件——它只记录你当前操作,但不落盘。
- 正确流程:先
File → Add Folder to Project…加入根目录 → 调整好布局和打开的文件 → 再Project → Save Project As…,选在项目根目录下保存为myapp.sublime-project - 保存后立刻生成同名的
.sublime-workspace,它默认不纳入 Git,建议加进.gitignore;而.sublime-project可以也建议提交,尤其含自定义settings或build_systems时 - 快捷键
Ctrl+Alt+P(Win/Linux)或Cmd+Ctrl+P(macOS)只列出「你亲手用Open Project加载过」的项目,不是磁盘上所有.sublime-project文件
项目配置里改 tab_size 或 folder_exclude_patterns,只对当前项目生效
这是 Sublime 项目管理最实用的一环:每个 .sublime-project 都能覆盖全局设置,比如前端项目用 2 空格,Python 项目用 4,互不干扰。
- 右键项目名 →
Edit Project,编辑 JSON。重点字段是folders和settings,例如:
{
"folders": [
{ "path": "src", "folder_exclude_patterns": [".git", "dist"] }
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true
}
}
folder_exclude_patterns 是路径级过滤,比全局 folder_exclude_patterns 更精准;但注意:它只影响侧边栏显示,不影响搜索(Ctrl+Shift+F 仍会扫被 exclude 的目录)settings 没生效?检查 JSON 语法是否合法(逗号、引号、括号),Sublime 不报错,只静默忽略整个 settings 块用 Project Manager 插件补足原生短板,特别是模糊搜索和固定常用项
原生 Switch Project 列表只按最近使用排序,项目一多就难找。插件不是必须,但省掉手动维护路径和命名习惯的麻烦。
- 安装后,
Ctrl+Alt+P呼出的是 Project Manager 的面板,支持中文输入、路径关键词匹配(比如输 “api” 就命中/backend/api)、按访问频次排序 - 它自动扫描你硬盘上所有
.sublime-project文件(可配置扫描路径),不用你一个个手动Open Project过一遍才进列表 - 右键侧边栏项目名,有 “Project Manager: Edit Project” 快捷入口;还能用命令
Project Manager: Quick Switch Project绑定更顺手的快捷键,比如Ctrl+Shift+O
最容易被忽略的点:项目切换后,旧窗口的 .sublime-workspace 不会自动清理,长期积累可能拖慢启动速度;定期删掉不用的 .sublime-workspace 文件,比依赖插件“自动管理”更可控。











