Sublime Text 启动时自动恢复上次文件夹需满足闭环条件:必须手动执行Project → Save Project As…生成合法.sublime-project文件,设"hot_exit": false并正常退出,且启动时不带任何命令行参数。

Sublime Text 不会“记住上次拖进来的文件夹”,只认你手动保存的 .sublime-project 文件 + 正常退出 + 未被命令行干扰的会话状态。改设置没用,关键在操作闭环。
Project → Save Project As… 是硬性前提
双击文件夹、subl .、甚至窗口标题显示路径,都不算“项目”。Sublime 只有在你执行菜单操作 Project → Save Project As… 后,生成合法的 myproject.sublime-project 文件,才进入项目模式。
- 保存后,窗口标题栏应出现项目名(或
Project菜单下该项目带对勾) -
.sublime-project至少要含"folders": [{ "path": "/your/project/path" }],空文件或格式错误会导致恢复失败 - 仅打开文件夹不保存项目 → 下次启动时该文件夹不会自动加载
hot_exit 设为 false 才能真正保存会话
很多人设了 remember_open_files 却无效,根本原因是 hot_exit 为 true:它让 Sublime “假装退出”,实际后台驻留,导致 Auto Save Session.sublime_session 文件不更新或为空。
- 必须设
"hot_exit": false,并用Ctrl+Q(Windows/Linux)或关闭所有窗口(macOS)正常退出 -
"remember_open_files": true和"restore_open_projects": true也要同时存在,缺一不可 - 检查用户设置(
Preferences → Settings右侧),不要只看默认设置——"restore_open_projects": false这种显式关闭会直接禁用项目恢复
带命令行参数的启动会彻底跳过恢复
只要启动时带任何参数,Sublime 就放弃加载上次会话。这不是 bug,是明确设计逻辑。
-
subl .、subl /path/to/folder、subl --new-window全部失效 - 桌面快捷方式目标字段里含
--multiinstance或其他参数,同样绕过恢复 - 只有纯
subl(终端执行)、双击图标、从 Dock/Launcher 启动,才会读取Auto Save Session.sublime-session - 想固定打开某项目?用
subl --project /path/to/project.sublime-project,但这和“恢复上次”是两套机制,互不干扰
会话文件损坏或路径错位是静默失败点
Sublime 完全依赖一个 JSON 文件存状态:Auto Save Session.sublime-session。它不存在、为空、权限不对,恢复就彻底静默失败,且不报错。
- Windows 路径:
%APPDATA%\Sublime Text 4\Local\Auto Save Session.sublime-session - macOS 路径:
~/Library/Application Support/Sublime Text 4/Local/Auto Save Session.sublime-session - Linux 路径:
~/.config/sublime-text-4/Local/Auto Save Session.sublime-session - 如果长期无法恢复,可先删掉这个文件,再正常退出一次,观察是否重建
最常被忽略的是:你以为“上次打开的就是项目”,其实只是临时文件夹;你以为“设置了就能恢复”,其实 hot_exit 为 true 已经让会话停在半路。恢复不是靠配置堆叠,而是靠 Save Project As… → hot_exit: false → Ctrl+Q → 纯命令启动 这个闭环链。断掉任意一环,就归零。











