Atom会话未恢复的首要原因是版本低于1.28.0，导致Nuclide序列化逻辑被跳过；需升级Atom并检查日志、手动恢复sessions/下workspace.json等文件，再配置session-settings.json控制恢复范围。
会话没恢复？先查 Atom 版本和日志
Atom 重启后没打开上次的文件、光标位置丢失、折叠状态清空——这通常不是配置没开，而是底层会话系统压根没跑起来。最常见原因是 Atom 版本过低：const MINIMUM_SUPPORTED_ATOM_VERSION = '1.28.0'，低于这个版本，Nuclide 的 serialize() 逻辑会被直接跳过。
- 运行
atom --version确认版本 ≥ 1.28.0；若低于，升级 Atom 是唯一解，重装插件无效 - 检查日志：Nuclide 用
log4js记录恢复失败细节，日志路径通常在~/.atom/logs/（macOS/Linux）或%APPDATA%\Atom\logs\（Windows），搜索关键词session、restore、serialize - 典型错误如
Failed to deserialize workspace state或Cannot read property 'deserialize' of undefined，基本指向模块加载失败或序列化数据损坏
手动恢复：别删 storage，先备份再换文件
Atom 的会话数据存在本地缓存里，不是“丢了就没了”。关键文件有三个：workspace.json（窗口布局）、projects.json（项目路径）、open-files.dat（打开的标签页列表）。它们都在 ~/.atom/storage/sessions/ 下（macOS/Linux）或 %APPDATA%\Atom\storage\sessions\（Windows）。
- 别直接删整个
storage目录——那会连插件设置一起清掉；只动sessions/子目录更安全 - 如果之前有备份（比如
nuclide_backup/），用cp ~/.atom/storage/nuclide_backup/*.json ~/.atom/storage/nuclide/替换即可 - 若完全没备份，可尝试从
~/.atom/storage/下找最近修改时间的workspace-*.json文件，改名为workspace.json后重启 Atom
选择性恢复：控制哪些文件自动打开
大型项目一启动就恢复 50+ 标签页，不仅卡顿，还可能因某一个文件路径失效导致整体会话加载失败。Nuclide 支持按 glob 模式过滤，靠的是项目级配置 .nuclide/session-settings.json。
- 在项目根目录新建该文件，内容示例：
{ "sessionRestore": { "includePatterns": ["**/src/**/*.{js,jsx,ts,tsx}"], "excludePatterns": ["**/*.test.{js,jsx,ts,tsx}", "**/node_modules/**"], "maxFilesToRestore": 12 } } -
includePatterns和excludePatterns是白名单优先，两者共存时 exclude 生效；路径匹配基于项目根目录，不是绝对路径 - 注意：
maxFilesToRestore是硬限制，超过数量的文件不会报错，只是静默丢弃——这点容易被忽略，导致以为配置没生效
折叠状态和终端分屏不恢复？检查持久化开关
代码折叠记忆和终端分屏布局属于 Nuclide 的独立模块，不依赖主会话系统，但默认可能关闭。比如 nuclide-file-tree 模块的折叠状态，需要显式开启持久化。
- 图形界面设置路径：
Nuclide > Settings > File Tree > Session Persistence，勾选Remember file folding state和Restore project tree expansion on startup - 等效的配置项写在
~/.atom/config.cson里是："*": "nuclide-file-tree": persistFoldStates: true restoreExpandedPathsOnStartup: true - 终端分屏记忆则由
nuclide-terminal控制，恢复提示 “恢复上次会话布局” 出现的前提是：上次关闭前终端面板处于展开状态，且未勾选Private Session Mode（该模式下所有会话数据禁用）
真正麻烦的不是找不到配置项，而是某些状态（比如某个远程文件的折叠路径）在跨平台或权限变更后无法反序列化——这时日志里往往只报 InvalidStateError，得结合 storage/sessions/ 下对应时间戳文件的手动比对才能定位。别跳过这一步。
