要让Atom启动时自动恢复上次项目和窗口,需启用core.restorePreviousWindowsOnStart: true;该设置仅恢复窗口及文件夹路径,不恢复未保存内容,且须避免与project-manager等插件冲突,配置错误或崩溃退出会导致失效。

如何让 Atom 启动时自动恢复上次打开的项目和窗口
Atom 默认不恢复工作区,必须手动开启 core.restorePreviousWindowsOnStart 才能生效。这不是 bug,是设计如此。
- 编辑
~/.atom/config.cson(macOS/Linux)或%USERPROFILE%\.atom\config.cson(Windows) - 在
core:区块下添加一行:restorePreviousWindowsOnStart: true - 确保该字段没被写错位置(比如误塞进
editor:或packages:下) - 保存后重启 Atom —— 不热重载,不重启无效
注意:这个设置只恢复窗口和已添加的项目文件夹路径,不恢复未保存的编辑内容(那是 autosave 插件的事)。
为什么改了配置却没恢复?常见失效原因
即使写了 restorePreviousWindowsOnStart: true,也可能完全不触发恢复。多数情况不是配置没生效,而是被其他机制覆盖或干扰。
-
project-manager或project-plus等插件默认启用自动恢复,会抢在 Atom 原生逻辑前加载自己的工作区快照,导致原生设置静默失效 - 项目根目录存在
.atom-project.json且含"window": {...}字段时,它会强制接管窗口状态,优先级高于全局配置 -
~/.atom/storage/下残留的旧窗口元数据(如window-state-开头的文件)可能与新版本 Atom 不兼容,造成恢复逻辑卡住或跳过 - Windows 用户若用快捷方式启动 Atom,且目标路径末尾带空格或引号不匹配,有时会导致配置加载失败(尤其从开始菜单启动时)
删掉 ~/.atom/storage/ 能解决哪些恢复异常
当 Atom 显示“空白窗口”“只恢复一个项目”“折叠状态错乱”或“标签页顺序颠倒”,大概率是 storage/ 里缓存的数据坏了。它不参与配置同步,但直接影响工作区还原行为。
-
storage/存的是运行时状态快照:窗口尺寸、面板位置、树视图展开节点、标签页顺序、甚至分割面板比例 - 这些数据格式随 Atom 版本更新而变;1.75+ 升级后,旧版
window-state-*.json可能被忽略或解析失败 - 安全做法是:关掉 Atom → 重命名
~/.atom/storage为storage.bak→ 启动 Atom → 观察是否恢复正常 - 若恢复成功,可手动从
storage.bak中提取需要的片段(如某个项目路径),再写入新config.cson的projectHome字段
真正容易被忽略的一点
Atom 的工作区恢复不是“记住你关机前的样子”,而是“记录最后一次干净退出时的窗口结构”。如果 Atom 是崩溃退出、被 kill -9 终止,或系统断电,storage/ 中的状态文件往往写入不完整,下次启动就会跳过恢复,直接走空白初始化流程——这种情况下,删 storage/ 不是修复手段,而是绕过损坏数据的必要操作。

















