Sublime Text 中真正可复用的工作区必须使用 .sublime-project 文件,而非 .sublime-workspace;后者仅为自动保存的临时状态快照,不含路径、设置等元信息,无法独立加载。

Sublime Text 本身不支持“保存当前所有打开文件+布局为一个可双击启动的工作区”这种功能——它只保存工作区(.sublime-workspace)作为辅助状态,真正能复原的只有项目(.sublime-project)。
为什么改了文件没出现在 workspace 里?
因为 .sublime-workspace 文件不是你手动管理的“工作区定义”,而是 Sublime 自动记录的临时状态:比如哪些文件是打开的、光标在哪、折叠了哪几行、当前在哪个标签页……它依赖对应的 .sublime-project 或“无项目模式”存在。单独双击 .sublime-workspace 文件,Sublime 会忽略它,直接启动空窗口。
-
.sublime-workspace永远不会被当作入口文件加载 - 你关掉 Sublime 再重开,只要没主动保存项目,它只会恢复上次的编辑状态(如果开启了
remember_open_files),但不会“按 workspace 复原布局” - 如果你没建
.sublime-project,那所谓“工作区”其实只是临时快照,换台电脑或删了 workspace 文件就彻底丢
怎么让一组文件+设置真正可复用?
必须用 .sublime-project。它是唯一能声明“这个目录下有哪些文件夹、默认编码、构建系统、侧边栏显示哪些路径”的配置文件。workspace 只是它的附属品,用来存运行时状态。
- 菜单栏选 Project → Save Project As…,存成
my-work.sublime-project - 保存后,Sublime 会自动生成同名的
my-work.sublime-workspace(别动它) - 下次双击
my-work.sublime-project,就能还原整个项目结构 + 所有已打开文件 + 窗口布局 - 想预设打开哪些文件?在
.sublime-project里加"files"字段,例如:{ "folders": [ { "path": "/path/to/src" } ], "files": ["README.md", "src/main.py"] }
常见误操作:把 workspace 当 project 用
很多人右键 .sublime-workspace → “用 Sublime Text 打开”,结果只看到空白窗口——这不是 bug,是设计如此。workspace 不含路径、不含设置,只存“此刻我长什么样”,没有上下文就无法复活。
- 错误做法:把
.sublime-workspace发给同事,指望对方双击就能看到你当时的 tabs - 正确做法:发
.sublime-project+ 告诉对方项目根目录在哪(或者用相对路径写进配置) - 如果项目里用了自定义构建系统或插件设置,记得在
.sublime-project的"settings"或"build_systems"里显式声明,否则 workspace 完全不记这些
真正麻烦的点在于:Sublime 的 UI 把 “Project” 和 “Workspace” 混着叫,菜单里写“Save Workspace”,实际保存的是 project 文件;而真正的 workspace 文件又藏在缓存目录里,还不能手动编辑。所以别纠结 workspace 能不能导出——盯住 .sublime-project 就对了。

















