project-manager在Atom ≥ 1.60中彻底失效，因官方移除atom.project.addPath等底层API；唯一可靠替代是project-plus，需apm安装后重启，通过Cmd+Alt+P切换并手动Save Workspace保存工作区。
project-manager 在 Atom 1.60+ 上已彻底失效，装了也起不来——这不是你操作错，是官方移除了它依赖的底层 API。
为什么 project-manager 安装后报 “No available version compatible”
Atom 自 1.60 版本起删除了 atom.project.addPath 等关键接口，而 project-manager 的核心逻辑完全依赖这些已被废弃的同步路径注册机制。运行 atom --version 确认版本 ≥ 1.60 后，就别再尝试 apm install project-manager —— 它连启动都做不到，更别说读写 ~/.atom/packages/project-manager/projects.cson。
常见误判点：
- 看到
projects.cson文件还存在，就以为插件“可能只是没启用” → 实际上该文件此时完全不被 Atom 或任何活跃插件读取 - 试图在
init.coffee里调用atom.project.addPath()模拟保存 → 该方法本身已在 1.60+ 中被移除，调用会直接报undefined is not a function - 降级到 1.59.x 虽能跑
project-manager，但会失去 TS 5.8+ 语法高亮、安全更新和多数新插件支持
project-plus 是当前唯一稳定可用的替代方案
project-plus 不读 projects.cson，也不依赖文件系统监听，而是直接对接 Atom 1.60+ 的新项目接口，安装即用。
实操步骤：
- 执行
apm install project-plus，安装后必须重启 Atom - 添加项目：Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Win/Linux）→ 输入
Project Plus: Add Project Folder→ 选路径 → 命名（建议用短横线，如backend-api，避免空格和特殊字符） - 保存工作区：Cmd+Shift+P →
Project Plus: Save Workspace→ 起名（如fullstack-workspace） - 下次启动：Cmd+Alt+P（macOS）或 Ctrl+Alt+P（Win/Linux）呼出面板，直接选择已保存的工作区
注意：project-plus 的工作区只保存「根目录列表」和「每个根目录下最近打开的文件」，不保存面板布局、光标位置或未保存的编辑状态。
不装插件时，内置 Project Viewer 能做什么
Atom 1.58+ 内置的 Project Viewer 支持基础多项目操作，但所有状态仅存于内存，关闭即丢。
可用命令：
-
Project > Add Project Folder（快捷键 Cmd+Shift+O / Ctrl+Shift+O）→ 每次加一个目录，树视图中平级显示，互不嵌套 -
Project: Switch Project（Cmd+Shift+P 输入）→ 只列出本次会话中已显式添加的根目录，不是历史记录 -
Project: Reveal in Finder→ 快速定位当前活动项目的根路径
性能提示：如果树视图卡顿、Cmd+P 搜索变慢，大概率是没配置 .atomignore。在项目根目录下建该文件，写入：node_modules/**、dist/**、build/**。
容易被忽略的关键细节
项目名称含空格或中文，会导致 Project Plus: Quick Switch Project 面板模糊搜索失灵；.atom-project.json 只影响编辑器行为（如 tabLength），对工作区保存/恢复毫无作用；拖拽多个文件夹进 Atom 窗口、右键 Reveal in Finder 后再拖入、File > Open 多选文件夹——这三种方式全部无效，Atom 只响应最后一个。
