Atom原生不保存多项目工作区,仅临时挂载文件夹;必须用project-manager插件,通过“Save Project”命名并存至projects.cson才能持久化恢复。

Atom 不保存“工作区”概念,只保存“项目文件夹”;所谓“快速保存工作区”,本质是手动固化当前打开的多个项目文件夹列表——必须靠 project-manager 插件,原生不支持。
为什么 Add Project Folder 后重启就只剩一个项目?
Atom 原生设计里,Add Project Folder 添加的文件夹只是临时挂载,不写入持久状态。每次重启,它只恢复最后一次通过该操作添加的文件夹,其余全部丢失。
- 这不是 bug,是 Atom 1.x 的明确行为:工作区无序列化机制,
serialize()方法只存面板布局、打开的文件等视图状态,不存项目根目录列表 - 你看到树视图里多个顶层文件夹,是因为它们在本次会话中被逐个添加过,但没被任何地方记录下来
- 直接拖拽文件夹进窗口完全无效——Atom 根本不监听窗口区域的 drop 事件,连尝试都不做
project-manager 插件怎么真正保存/恢复多项目?
装完 project-manager 后,它会在 ~/.atom/packages/project-manager/projects.cson 里存你命名过的项目路径。关键不是“加”,而是“存名”。
- 添加项目后,按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Win/Linux),输入Project Manager: Save Project,给当前组合起个名字(比如my-backend) - 下次启动,用
Project Manager: Quick Switch Project就能一键加载整个项目列表,包括所有文件夹、已开文件、面板位置 - 别依赖插件的自动保存开关——有些版本默认关着,必须手动执行一次
Save Project才写入磁盘 - 如果项目路径移动了,
projects.cson里的绝对路径会失效,需手动编辑该文件或删掉重存
config.cson 里能绕过插件直接存项目列表吗?
不能。Atom 的用户级 config.cson 不提供 projectFolders 或类似配置项,所有项目路径管理都在插件层或内存中完成。
-
core.projectHome只影响新建文件时的默认保存位置,和项目列表无关 - 有人试图在
init.coffee里调用atom.project.addPath(),但该方法只在当前会话生效,且重启后不持久 - 唯一可靠路径:接受
project-manager是事实标准,别自己造轮子——它的projects.cson格式稳定,2026 年仍在维护,且支持 Git 同步
真正容易被忽略的是:项目名称不能含空格或特殊字符,否则 Quick Switch Project 模糊搜索可能匹配失败;另外,如果你用 .atom-project.json 设置项目专属配置,它只影响编辑器行为(如 tabLength),对项目列表的保存和恢复毫无作用。

















