Sublime Text 的项目管理依赖 .sublime-project 文件固化工作区状态。需通过 Project → Save Project As… 主动保存,才能记录打开文件、折叠状态、光标位置等;仅 File → Open Folder 不生成项目文件,无法在 Switch Project 中显示;命令行应指定 .sublime-project 文件路径而非文件夹。

Sublime Text 本身没有“项目管理器”面板,但通过 Project 功能可以真正保存和切换多个工程——关键不是靠文件夹打开,而是用 .sublime-project 文件固化工作区状态。
如何正确保存当前工作区为 Sublime 项目
直接关闭窗口再重开文件夹,不会记住你上次打开的文件、折叠状态、光标位置或已启用的构建系统。必须主动保存为项目:
- 菜单栏选择 Project → Save Project As…,保存为
xxx.sublime-project(建议放在项目根目录下) - 保存后,Sublime 会自动记录:所有已打开的文件、文件夹路径、侧边栏展开状态、每个文件的滚动位置和折叠节点
- 如果没手动保存过项目,
Project → Switch Project列表里只会显示 “(none)” 或最近几个未命名工作区(不可靠)
为什么 Project → Switch Project 找不到你的项目
这个菜单只列出两类路径下的 .sublime-project 文件:
- Sublime 的
Packages/User/目录(默认项目存档位置) - 你曾经通过
File → Open Folder…打开过的任意文件夹中,**恰好存在**.sublime-project文件
常见误操作:File → Open Folder 后直接关掉,没点 Save Project As → 不会产生项目文件 → 不会出现在切换列表。
命令行快速打开指定 Sublime 项目
适合配合脚本或终端习惯用户,避免反复点菜单:
- 确保 Sublime 命令行工具
subl已安装(macOS/Linux)或subl.exe在 PATH 中(Windows) - 直接执行:
subl /path/to/your/project.sublime-project
- 注意:必须指定
.sublime-project文件本身,不是文件夹路径;否则仍以普通文件夹方式打开,不加载项目状态
多项目协作时容易忽略的细节
.sublime-project 是纯 JSON,可编辑,但改错会导致项目无法加载:
- 不要手动修改
folders数组里的路径为相对路径(Sublime 不支持),必须是绝对路径或使用$project_path变量 - 若项目含多个根目录(如前端+后端),
folders是数组,每个对象需明确写path字段 - 插件设置(如
SideBarEnhancements或GitGutter)通常不随项目保存,它们属于用户级配置,需单独处理
真正可靠的项目切换,依赖的是那个被保存下来的 .sublime-project 文件——它不在菜单里显眼,但它是唯一能固化你工作上下文的东西。










