sublime text 启动时自动恢复上次项目需同时满足:项目文件已通过“project → save project as…”显式保存、关闭前项目处于激活状态、用户设置中启用"restore_open_projects"且未被命令行参数覆盖。

Sublime Text 启动时自动恢复上次打开的项目(.sublime-project)
默认情况下 Sublime Text 不会自动加载上次关闭时的项目,哪怕你用的是 .sublime-project 文件。它只记文件列表,不记项目配置——除非你明确告诉它“记住项目上下文”。
关键在两个地方:设置项开启 + 项目文件真实存在且被主动保存过。
-
必须手动保存一次项目:菜单栏 Project → Save Project As…,存为
xxx.sublime-project,否则 Sublime 认为这是无项目状态 - 启用
remember_open_files和hot_exit:这两个开关控制文件/会话恢复,但它们本身不触发项目加载;项目加载依赖restore_open_projects - 真正起作用的是
restore_open_projects,它默认是true,但仅在 Sublime 检测到合法的.sublime-project文件路径时才生效
为什么改了 settings 还不自动开项目?常见断点排查
不是所有“上次项目”都能被恢复。Sublime 只恢复那些满足以下全部条件的项目:
- 关闭前,该
.sublime-project文件已通过 Project → Save Project As… 显式保存(而非仅保存工作区) - 关闭 Sublime 时,该项目处于激活状态(即项目名出现在窗口标题栏或菜单栏 Project 下有对勾)
-
Preferences.sublime-settings中未设"restore_open_projects": false(检查用户 settings,别只看默认 settings) - 启动时没有传入命令行参数(如
subl .或subl /path/to/file),这类调用会覆盖会话恢复逻辑
Windows/macOS/Linux 下配置路径与注意事项
配置文件位置不同,但设置项完全一致。修改的是用户级 Preferences.sublime-settings,不是默认文件。
- Windows:
%APPDATA%\Sublime Text\Packages\User\Preferences.sublime-settings - macOS:
~/Library/Application Support/Sublime Text/Packages/User/Preferences.sublime-settings - Linux:
~/.config/sublime-text/Packages/User/Preferences.sublime-settings - 确保 JSON 格式合法:逗号不能多、引号必须英文、最后一项后不能有逗号
- 推荐最小必要配置(其他项保持默认即可):
{ "hot_exit": true, "remember_open_files": true, "restore_open_projects": true }
项目没恢复?先确认是不是“项目”还是“只是开了几个文件”
很多人误以为“上次关掉时开着 project-folder 里的文件” = “项目被记住了”,其实不是。Sublime 区分得很清楚:
- 只打开文件夹(File → Open Folder…)→ 是“无项目工作区”,关闭后只恢复文件列表,不恢复项目配置(如 build system、folders 过滤等)
- 打开的是
.sublime-project文件(双击或 Project → Open Project…)→ 才算真正进入项目模式,关闭时才会记录项目路径 - 如果项目里加了自定义
settings或build_systems,但启动后没生效,大概率是因为根本没走项目加载流程——检查窗口右下角是否显示项目名










