sublime text 无传统“工程”概念,仅通过.sublime-project文件定义工作区;必须先open folder才能save project as,且修改后需重载生效,路径推荐用${folder}变量。

Sublime Text 里没有“工程”概念,只有「工作区」(.sublime-project)
Sublime Text 本身不维护传统 IDE 那种“项目工程”,它靠 .sublime-project 文件定义当前打开的文件夹、设置、构建系统等。所谓“建工程”,本质是手动创建或生成这个 JSON 文件。
常见错误现象:Project → Save Project As… 灰掉、菜单里找不到选项、保存后下次打开没记住文件夹——通常是因为你当前只打开了单个文件,没打开文件夹(即没进入“侧边栏有文件树”的状态)。
- 必须先通过
File → Open Folder…打开一个目录,侧边栏出现文件树,Project → Save Project As…才可用 -
.sublime-project文件默认保存在项目根目录下,但也可以放在别处;只要用它打开 Sublime,就会加载对应配置 - 如果只打开单个文件(没开文件夹),Sublime 不会允许存 project 文件——它压根没上下文来组织“项目”
怎么保存当前打开的文件夹和布局为可复用的工作区
你看到的标签页顺序、折叠状态、光标位置、甚至已开启的终端(如果装了 Terminus),默认不会被保存。真正能持久化的只有:打开的文件夹路径、文件列表(可选)、窗口布局(分组)、各视图的语法高亮和编码设置。
实操建议:
- 确保已通过
File → Open Folder…打开目标目录 - 调整好你想要的分组(比如拖文件到新 Group)、打开必要文件、设置好语法(
View → Syntax → …) - 执行
Project → Save Project As…,存为xxx.sublime-project(建议和文件夹同名) - 之后双击该文件,或用命令行
subl --project /path/to/xxx.sublime-project启动,就能还原
为什么改了 .sublime-project 文件后没生效
Sublime 不监听 project 文件变更,也不会热重载。编辑 JSON 后必须关闭再重新用它打开,或者从菜单 Project → Open Project… 重新加载。
容易踩的坑:
- 手写 JSON 时漏逗号、多逗号、引号不闭合——Sublime 不报错,但整个 project 配置会被忽略(静默失败)
- 路径写绝对路径(如
"path": "/Users/me/src/app")会导致换电脑失效;推荐用${folder}变量,例如"path": "${folder}/src" -
"folders"数组里不能写空对象或非法字段,否则整个 section 被跳过;最小合法结构是:{"folders": [{"path": "."}]}
想快速切换多个项目?别依赖菜单,用命令面板或快捷键
频繁点 Project → Open Project… 很慢。Sublime 原生支持项目历史和快速切换,但默认没绑定快捷键。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Project: Switch Project,回车即可唤出最近项目列表 - 想固定常用项目?把它们的
.sublime-project文件放进Packages/User/Projects/目录,再安装插件Quick Projects(非官方但轻量)可一键呼出 - 注意:
Project → Recent Projects只记录 .sublime-project 文件路径,不是所有打开过的文件夹都算“项目”










