Atom 1.60+ 无法使用 project-manager，必须用内置 Project Viewer 或 project-plus；添加多个项目文件夹需依次执行 Project > Add Project Folder（macOS 快捷键 Cmd+Shift+O，Windows/Linux 为 Ctrl+Shift+O），每次添加一个目录，重启后仅保留最后添加的项目，持久化需用 project-plus 或终端命令 atom /path/A /path/B 启动。
Atom 1.60+ 版本无法使用 project-manager，硬装必报 No available version compatible 错误；多项目管理必须靠内置 Project Viewer 或改用 project-plus。
怎么添加多个项目文件夹（不拖拽、不右键）
Atom 不监听窗口区域的拖入事件，也不支持 File > Open 多选文件夹——这些操作只会加载最后一个。唯一可靠路径是菜单命令：
-
Project > Add Project Folder（macOS 快捷键Cmd+Shift+O，Windows/Linux 是Ctrl+Shift+O） - 每次只能加一个目录，加几次，树视图就显示几个并列根节点
- 不能嵌套：如果已加
/src/web，再加/src/web/src，后者会作为独立顶层节点出现，不是子目录 - 添加后，
Cmd+P/Ctrl+P模糊搜索才覆盖该目录下所有文件
为什么重启 Atom 后只剩一个项目？
Atom 内置的 Project Viewer（1.58+ 自带）不写配置文件，所有项目路径只存在内存中。关掉即清空，下次启动默认只恢复「最后添加的那个」。
-
Project: Switch Project命令只列出当前工作区里已通过Add Project Folder显式加入的根目录，不是历史记录 - 想快速切回 A/B/C 三个项目？必须先手动重新添加一遍，再用该命令切换
- 替代方案：终端启动时直接指定多个路径，如
atom /path/to/A /path/to/B /path/to/C，但无法动态增删
Atom 1.60+ 上还能用 project-manager 吗？
不能。官方在 1.60 中移除了 atom.project.addPath 等底层 API，project-manager 依赖这些接口，已彻底失效。
- 运行
atom --version确认版本，≥ 1.60 就别试apm install project-manager—— 报错是设计使然，不是你配错了 - 降级到 1.59.x 可行，但会失去安全更新、新语言支持（如 TS 5.8+ 高亮）和多数新插件兼容性
-
~/.atom/projects.cson文件仍存在，但project-manager插件本身起不来，这个文件形同虚设 - 真正可用的替代是
project-plus：安装即用（apm install project-plus），支持多根工作区、快捷键Cmd+Alt+P（macOS）一键切换，不读projects.cson，也不依赖文件系统监听
多项目下性能卡顿怎么办？
树视图渲染、Cmd+P 搜索变慢、甚至弹出「heavy file」警告，往往不是 Atom 本身问题，而是项目目录没做忽略。
- 务必在每个项目根目录下建
.atomignore，写入：node_modules/**、dist/**、build/** - 避免把
~/Downloads或超大日志目录加进项目——.atomignore对这些无效，得从源头剔除 - 加 2–3 个中小型项目一般没问题；一旦某个根目录含未忽略的
node_modules，搜索响应可能从毫秒级拖到秒级 -
tree-view-sort插件可让文件夹始终排在文件前，但解决不了底层扫描压力，优先做忽略
真正容易被忽略的是：项目管理不是「加完就完」，而是每次启动都要重走一遍 Add Project Folder 流程，除非你用 project-plus 或终端命令固化路径——没有中间态，也没有半自动方案。
