Sublime Text 的“最近项目”完全依赖 Session.sublime_session 中的 recent_workspaces 数组,仅通过 Project → Open Project… 触发写入;双击文件夹、拖入目录或直接打开 .sublime-workspace 均无效;清空需手动编辑该文件并重置为 "recent_workspaces": []。

Sublime Text 没有“切换最近项目”的实时操作,Project → Recent Projects 菜单项只是静态快照,必须靠手动清理 Session.sublime_session 才能重置。
为什么 Project → Recent Projects 点了没反应或列表不更新
菜单栏里显示的“最近项目”完全来自 Session.sublime_session 文件里的 recent_workspaces 数组,不是运行时缓存,也不是插件动态维护的。你双击侧边栏文件夹、拖入目录、甚至用 subl --project 命令打开,只要没走 Project → Open Project… 这条路径,就不会写入该数组。
常见误操作包括:
- 直接双击
.sublime-workspace文件 —— 它不含项目路径,只存窗口状态,路径失效时会报Unable to open project: path does not exist - 只执行
File → Open Folder…但跳过Project → Save Project As…—— 这样根本没生成有效.sublime-project,也就不会被记入 recent_workspaces - 用
Project → Switch Project(菜单里有这选项)—— 它实际跳转的是最近打开的文件夹,和.sublime-project无关
如何真正清空 Recent Projects 列表
必须关闭 Sublime Text 后手动编辑配置文件,不能用命令面板或菜单操作:
- 先彻底关闭 Sublime:Windows 查任务管理器确认
sublime_text.exe和subl.exe都已退出;macOS 用活动监视器强制退出 - 用外部编辑器(别用 Sublime 自己)打开
Session.sublime_session:
Windows:%APPDATA%\Sublime Text\Local\Session.sublime_session
macOS:~/Library/Application Support/Sublime Text/Local/Session.sublime_session
Linux:~/.config/sublime-text/Local/Session.sublime_session - 搜索
"recent_workspaces",将其值改为"recent_workspaces": [],确保 JSON 格式合法(逗号、引号、括号匹配) - 保存后重启 Sublime,菜单即为空
想“切换”项目?只能开新窗口加载 .sublime-project
Sublime Text 不支持单窗口内切换项目上下文(比如构建系统、设置、主题),所谓“切换”本质是启动一个新窗口并加载指定 .sublime-project 文件:
- 正确流程:先
File → Open Folder…选根目录 → 再Project → Save Project As…,把.sublime-project保存在**同一级目录下**(如myapp/myapp.sublime-project) - 之后才能在
Project → Open Project…或Ctrl+Alt+P(macOSCmd+Ctrl+P)中看到它 -
Ctrl+Alt+P列表只包含你亲手用Open Project…加载过的项目,不是磁盘上所有.sublime-project文件 - 如果开了多个项目窗口,用系统快捷键切换:
Windows/Linux:Alt+Tab;macOS:Cmd+`(反引号)
最常被忽略的一点:没有 Save Project As… 就等于没有项目。哪怕你把所有配置都写进 Preferences → Settings – Project,只要没生成并加载 .sublime-project,那些设置就完全不生效,recent_workspaces 也不会记录它。











