Sublime Text 的项目本质是 .sublime-project 后缀的 JSON 配置文件,记录工作区路径、打开文件、折叠状态、构建系统等;无此文件则仅为临时文件浏览,关掉即丢失所有状态。

Sublime Text 里 Project 文件本质是什么
Sublime Text 的项目不是“文件夹集合”,而是以 .sublime-project 为后缀的 JSON 配置文件,它记录了工作区路径、已打开的文件、折叠状态、构建系统等。没有这个文件,Sublime 就只是“打开几个文件”,而不是“加载一个项目”。很多用户误以为拖文件夹进 Sublime 就等于打开了项目,其实只是临时浏览——关掉再开,所有标签页、书签、折叠状态全丢。
用 Project → Save Project As… 才算真正保存项目
菜单栏点 Project → Save Project As…,选个位置(建议和项目根目录同级,比如 myapp/myapp.sublime-project),就能生成一个可复用的项目文件。之后双击该文件,或用命令行 subl myapp.sublime-project,Sublime 就会按原样恢复整个工作区。
- 别存成
.sublime-workspace:那是自动保存的临时状态,不带配置,不能共享 - 如果项目里用了自定义构建系统或设置,记得在
.sublime-project里显式写进"settings"或"build_systems"字段 - Git 提交时建议把
.sublime-project加入版本控制,但排除.sublime-workspace
快速切换项目的两个可靠方式
Sublime 原生不支持“项目管理器”面板,但有稳定、低侵入的切换路径:
-
快捷键 + 命令面板:按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac),输入Project: Switch Project,回车后列出所有最近打开过的.sublime-project文件,上下键选择即可 -
直接双击
.sublime-project文件:只要系统关联了 Sublime,双击就等价于subl path/to/project.sublime-project,比从菜单找快得多 - 插件如
ProjectManager虽然能列表管理,但容易和原生命令冲突,尤其在多窗口场景下状态不同步
为什么 Project → Open Project… 有时不生效
常见现象:点了 Open Project…,选中 .sublime-project,结果什么都没变,或者只打开了文件没恢复标签页。根本原因是当前已有项目在运行,而 Sublime 默认不会“覆盖”当前项目,而是新开一个窗口——但如果你禁用了多窗口(比如设置了 "open_files_in_new_window": false),它就静默失败。
- 解决办法:先执行
Project → Close Project,再Open Project… - 或者用命令面板执行
Project: Switch Project,它会主动关闭当前项目并加载新项目 - 检查
Preferences → Settings – User是否含"remember_open_files": true,否则即使项目加载成功,上次的标签页也不会还原
{
"folders":
[
{
"path": "src"
}
],
"settings":
{
"tab_size": 2,
"translate_tabs_to_spaces": true
}
}
项目文件结构简单,但字段写错一个逗号就加载失败;很多人改完配置发现不生效,其实是 JSON 格式错误,Sublime 不报错也不提示,只会静默忽略整个文件。










