工作区文件(.sublime-workspace)用于保存项目窗口布局、打开文件等运行时状态,需先创建项目文件(.sublime-project),再通过调整布局触发自动生成;建议忽略该文件于版本控制,并可手动配置项目设置以增强功能。

在 Sublime Text 中,工作区(.sublime-workspace)文件用于保存项目的窗口布局、打开的文件、折叠的代码块状态等运行时信息。它通常与项目文件(.sublime-project)配合使用,实现对多项目、多窗口的高效管理。
1. 创建项目并生成 .sublime-project 文件
要创建工作区,必须先有一个项目文件:
- 打开 Sublime Text,点击菜单栏的 Project > Save Project As…
- 将项目保存为
项目名.sublime-project,例如:MyProject.sublime-project - 保存后,Sublime 会自动加载该项目
2. 自动生成 .sublime-workspace 工作区文件
当你修改了当前项目的窗口状态(如分屏、打开文件、调整布局),Sublime 会自动生成对应的 workspace 文件:
- 打开多个文件或使用 View > Layout 设置分屏布局
- 再次进入 Project > Save Project As…,你会发现 Sublime 自动提示也保存一个
项目名.sublime-workspace文件 - 选择保存该文件到同一目录下,例如:
MyProject.sublime-workspace
注意:.sublime-workspace 文件通常包含用户特定的运行状态(如打开的标签页、光标位置),建议不提交到版本控制系统(如 Git)。可在 .gitignore 中忽略它。
3. 手动编辑 .sublime-project 和 .sublime-workspace(可选)
这两个文件都是 JSON 格式,支持手动配置增强功能:
- .sublime-project 可配置项目根目录、文件夹排除规则、构建系统等
- .sublime-workspace 存储窗口状态,一般无需手动编辑
示例 .sublime-project 配置:
{
"folders": [
{
"path": ".",
"folder_exclude_patterns": [".git", "node_modules"],
"file_exclude_patterns": ["*.log"]
}
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true
}
}
4. 使用工作区的优势
- 支持多窗口、多项目同时工作
- 保留每个项目的打开文件和布局状态
- 便于团队共享项目结构(通过 .sublime-project)
- 提高开发效率,关闭后再打开能恢复现场
基本上就这些。只要先保存 project 文件,再调整布局或打开文件,Sublime 就会提示你保存 workspace 文件,流程自然且简单。关键是理解 project 定义“什么属于项目”,而 workspace 记录“你如何使用它”。










