Sublime Text 中真正可复用的项目文件是 .sublime-project,.sublime-workspace 仅为运行时快照、不可手动加载或编辑;正确流程是先 Open Folder 再 Save Project As…,且项目必须存于根目录下,窗口标题显示项目名才表示激活成功。

Sublime Text 的工作区(workspace)不是可加载入口
双击 .sublime-workspace 文件只会启动一个空窗口,不会还原项目结构或设置——它只是运行时快照,不含路径、构建系统、settings 等元信息。真正能复用的只有 .sublime-project 文件。
常见错误现象:
- 右键
.sublime-workspace→ “用 Sublime Text 打开”,结果一片空白 - 同事发来一个
.sublime-workspace,你双击后什么也没出现 - 改了
.sublime-project里的"tab_size",但没生效
原因很简单:.sublime-workspace 不参与项目加载逻辑,只在已有项目上下文中被自动读取和更新。它甚至不能手动编辑(是二进制 JSON),强行修改会破坏校验或被下次启动覆盖。
正确创建可切换的项目:必须先 Open Folder,再 Save Project As…
Sublime 不允许从空窗口直接新建项目。所谓“项目”,本质是把当前打开的文件夹 + 配置固化成一个 JSON 文件。顺序错了,Project → Save Project As… 就是灰色不可点。
实操步骤:
- 点击
File → Open Folder…,选中你的项目根目录(如/Users/me/my-django-app) - 此时侧边栏出现文件树,菜单项
Project → Save Project As…才可用 - 保存路径必须选进刚才打开的那个文件夹里,文件名建议为
my-django-app.sublime-project(不带空格/中文) - 保存后,Sublime 自动在同目录生成配套的
my-django-app.sublime-workspace
关键信号:窗口标题栏显示 my-django-app — Sublime Text,这才是“项目已激活”的唯一可靠标志。
让 Ctrl+Alt+P(Win/Linux)或 Cmd+Ctrl+P(macOS)列出你的项目
Project → Switch Project 和快捷键调出的列表,只显示「你亲手通过 Project → Open Project 加载过的 .sublime-project 文件」,不是磁盘上所有同名文件。
如果列表为空,说明你还没真正加载过任何项目。补救方法:
- 先
File → Open Folder…打开任意一个项目根目录 - 再
Project → Save Project As…存为xxx.sublime-project - 然后
Project → Close Project关掉当前项目 - 最后
Project → Open Project…选中刚保存的xxx.sublime-project
这时它才会出现在 Ctrl+Alt+P 列表里。注意:双击 .sublime-project 文件也能加载,但首次必须走菜单流程,否则不会被记录进历史列表。
多项目并行:不是标签页切换,而是开多个窗口
Sublime 每个窗口只能绑定一个 .sublime-project。所谓“管理多个项目”,就是开多个窗口,每个窗口加载一个独立的 .sublime-project。
容易踩的坑:
- 误以为
Add Folder to Project…是切换项目——它只是把另一个目录挂进当前项目,所有设置、折叠状态、构建系统仍共享 - 把
.sublime-project放到 Sublime 安装目录或Packages/下——路径解析会失败,必须放在项目根目录下 - 在
.sublime-project中写死绝对路径(如"path": "/home/user/myapp")——迁移项目或换电脑就断链;应优先用相对路径"path": "."
真正麻烦的地方在于:UI 上“Project”和“Workspace”混着叫,菜单里写着“Save Workspace”,实际保存的是 .sublime-project;而真正的 .sublime-workspace 又藏在缓存目录里,还不受版本控制——它只该被 .gitignore 掉。

















