atom 1.60+ 必须用 project-plus,project-manager 已彻底失效;需运行 apm install project-plus 并重启,通过 cmd+shift+o 添加项目、cmd+alt+p 保存和切换工作区,且 tree-view 必须启用、项目须显式添加。

Atom 1.60+ 必须用 project-plus,project-manager 已彻底失效
如果你的 Atom 版本是 1.60 或更高(运行 atom --version 确认),project-manager 插件根本无法安装或启用——不是配置问题,是官方移除了它依赖的 atom.project.addPath 等 API。执行 apm install project-manager 必报 No available version compatible,手动编辑 ~/.atom/projects.cson 也完全无效。
唯一可行路径是换用 project-plus:
- 运行
apm install project-plus,安装后必须重启 Atom - 它不读
projects.cson,不依赖旧 API,直接对接当前atom.project接口 - 无需额外配置,快捷键
Cmd+Alt+P(macOS)或Ctrl+Alt+P(Win/Linux)即可调出项目切换面板
添加和保存多项目工作区的正确流程
project-plus 不会自动记录你打开过的目录,所有项目必须显式添加并手动保存,否则切换面板为空。
- 先按
Cmd+Shift+O(macOS)或Ctrl+Shift+O(Win/Linux)打开Project: Add Project Folder,逐个添加你要管理的根目录(如/home/user/src/frontend、/home/user/src/backend) - 添加完成后,按
Cmd+Alt+P呼出面板,选中当前组合 → 按Enter或点击Save current workspace - 起名时避免空格和特殊字符(
my-backend可行,my backend或my-backend!会导致模糊搜索失效) - 下次启动 Atom 后,再按
Cmd+Alt+P输入名字,就能一键加载全部根目录 + 各自最近打开的文件标签页
Tree View 为空?先检查这三件事
即使装了 project-plus,左侧目录树仍为空,大概率不是插件问题,而是 Atom 底层未激活项目视图。
-
tree-view包必须在Settings → Packages中处于 Enabled 状态(不能是灰色Disabled) - 项目必须通过
Project → Add Project Folder显式添加;拖拽文件夹进窗口或双击单个文件无效 - 确保
Tree View面板有焦点:按Cmd+0(macOS)或Ctrl+0(Win/Linux)切过去,再按Cmd+\显示/隐藏一次;若启用了vim-mode,需先按Esc退出插入模式
别被“Project Viewer”误导:它不是插件,也不持久
Atom 1.58+ 内置了 Project Viewer 功能,不是叫 project-viewer 的插件——网上搜不到、apm install project-viewer 必报 Package not found,因为它根本不存在。
这个内置功能支持多根添加(Project: Add Project Folder),但重启后所有项目丢失,这是设计如此,不是 bug。想长期复用 A+B+C 这组目录,必须靠 project-plus 保存工作区。它只存根目录路径和已打开的文件标签页状态,不保存面板布局、光标位置或未保存的编辑内容。











