Atom多项目管理必须用Project > Add Project Folder（快捷键Cmd+Shift+O/Ctrl+Shift+O），拖拽、右键打开或File > Open均无效；每次添加一个目录，重启后仅保留最后一个，持久化需project-plus或终端启动atom /path/A /path/B。
必须用 Add Project Folder，拖拽完全无效
Atom 不监听窗口区域的拖入事件，右键“在 Finder 中显示”再拖进窗口、或 File > Open 多选文件夹，这些操作都只会加载最后一个路径。唯一有效方式是菜单 Project → Add Project Folder（macOS 快捷键 Cmd+Shift+O，Windows/Linux 为 Ctrl+Shift+O），每次只能加一个目录。
添加后，每个文件夹作为独立根节点并列显示在 tree-view 中，不嵌套；Cmd+P/Ctrl+P 模糊搜索才覆盖该目录下所有文件。
- 已加
/src/web，再加/src/web/src，后者会作为新顶层节点出现，不是子目录 - 确保
Packages → tree-view处于Enabled状态，且未被vim-mode等插件拦截快捷键 - 按
Cmd+\或Ctrl+\强制显示/隐藏树视图，有时焦点不在其上会导致空白
重启后只剩一个项目？这是设计如此
Atom 内置的 Project Viewer（1.58+ 自带）只把项目路径存在内存里，关掉就清空。下次启动默认只恢复「最后添加的那个」，不是 bug，是机制限制。
Project: Switch Project 命令只列出当前工作区中已通过 Add Project Folder 显式加入的根目录，不是历史记录，也不是最近打开过的任意文件夹——没加过，列表就是空的。
- 想快速从 A 切到 C，必须先手动重新添加 A、B、C，再运行该命令选 C
- 终端启动可绕过：执行
atom /path/to/A /path/to/B /path/to/C，但无法后续动态增删 - 若项目含大量
node_modules或dist/，虽能添加，但树渲染和搜索会明显变慢
Atom ≥ 1.60 时 project-manager 已彻底失效
1.60 版本移除了 atom.project.addPath 等底层 API，project-manager 插件依赖这些接口，硬装必报 No available version compatible 错误——这不是你配错了，是官方主动废弃。
替代方案只有两个可靠选择：
-
project-plus：运行apm install project-plus，支持多根工作区、Cmd+Alt+P（macOS）一键切换，不读写~/.atom/projects.cson，避免因语法错误导致 Atom 启动卡死 - 终端启动 + shell alias：比如
alias atom-work='atom /path/A /path/B /path/C'，适合固定组合，但无法运行时修改
别碰 projects.cson 文件——它在 1.60+ 下形同虚设，手动编辑极易引发启动失败。
搜索不到新文件？Fuzzy Finder 不是实时索引
Cmd+P 依赖后台索引，刚添加文件夹或新建文件不会立刻出现。等 2–3 秒，或手动触发重建：Cmd+Shift+P → Fuzzy Finder: Rebuild Index。
常见漏查点：
- 确认文件在已添加的项目根目录下（不是嵌套在未添加的父目录里）
- 检查
core.ignoredNames默认值是否屏蔽了目标路径（如node_modules、.git） - 项目根目录下加
.atomignore，写入node_modules/**和dist/**，比改全局设置更安全 - 启用
Ignore VCS Ignored Paths时，gitignore里的路径也不会进搜索
真正麻烦的不是加项目，而是当多个项目共存时，tree-view 渲染、Cmd+P 响应、甚至大文件警告都可能突然变慢——这往往不是 Atom 本身的问题，而是目录没做忽略，或者插件配置冲突。动手前先看一眼 ~/.atom/config.cson 里有没有残留的旧插件配置项。
