Session恢复仅依赖Auto Save Session.sublime_session文件,与.sublime-project无关;项目切换通过Open Project覆盖当前会话,且需满足保存、激活、restore_open_projects为true三条件才记忆项目。

Sublime Text 的项目切换和 Session 恢复是两套独立机制,强行混用反而导致“想切项目却加载了旧会话”或“项目打开了但文件没恢复”。必须分清边界、明确触发条件。
Session 恢复只认 Auto Save Session.sublime_session,不认 .sublime-project
启动时自动恢复的文件夹、文件、标签页、光标位置,全部来自 Auto Save Session.sublime_session 文件——它和你有没有保存过 .sublime-project 无关。哪怕你从没建过项目,只要 remember_open_files 和 hot_exit 配置得当且正常退出,照样能恢复上次打开的任意文件夹。
-
hot_exit: true+ 异常退出(如 kill 进程)→Auto Save Session.sublime_session不更新,下次启动就是空窗口 -
hot_exit: false+ 正常退出(Ctrl+Q/Cmd+Q)→ 强制写入会话,恢复最可靠 - 手动执行
Save Session命令保存的会话,是独立文件(如work.sublime_session),不会影响自动恢复逻辑
项目切换(Project → Open Project…)会覆盖当前 Session 状态
通过菜单或命令行 subl --project 打开一个 .sublime-project 文件时,Sublime 会:关闭当前所有窗口 → 加载该项目定义的文件夹/设置/构建系统 → 但不会自动恢复该项目上次的打开文件列表,除非该项目此前被设为“激活状态”且 restore_open_projects 生效。
记录结构化的Claude Code轨迹、影子git diff,并在代理行为需要法医级调试而非临时转录审查时回放分支。
- 项目要“被记住”,必须满足三个条件:
Project → Save Project As…保存、关闭前该项目处于激活状态(标题栏显示项目名)、用户设置中"restore_open_projects": true - 仅靠
subl --project path/to/project.sublime-project启动,会绕过会话恢复,Auto Save Session.sublime_session完全不参与 - 侧边栏双击文件夹、拖入文件夹、
File → Open Folder…—— 这些操作不会注册为“项目”,也不会写入recent_workspaces
“最近项目”菜单项是静态快照,不是实时同步
Project → Recent Projects 显示的内容,完全来自 Session.sublime_session 文件里的 recent_workspaces 字段,不是动态扫描磁盘或读取历史记录。它只在你显式执行 Project → Open Project… 或 subl --project 时追加路径。
- 清空该菜单,必须彻底关闭 Sublime,再用外部编辑器打开
Session.sublime_session,把"recent_workspaces": [...]改成"recent_workspaces": [] - 原生没有
clear_recent_projects命令,控制台执行会报错Unknown command: clear_recent_projects - 插件(如 Project Manager)可能接管此逻辑,一旦启用,就得按插件规则管理,和默认行为互斥
真正容易被忽略的细节
会话恢复不是“启动即生效”的魔法——它依赖退出那一刻的落盘动作是否完成。哪怕所有配置都对,如果你在 macOS 上只关掉所有窗口却不按 Cmd+Q,或 Windows 上用任务管理器杀掉 subl.exe,Auto Save Session.sublime_session 就停在旧时间戳。别凭印象判断“应该恢复了”,直接去文件里看内容是不是包含你刚编辑的文件路径和最新修改时间。










