project-manager 在 atom 1.60+ 中彻底失效，因官方移除其依赖的底层 api 且该插件自 2023 年起停止维护；替代方案为使用内置 project viewer 或活跃维护的 project-plus 插件。
project-manager 在 Atom 1.60+ 中已彻底失效，无法安装或正常工作——这不是操作问题，而是官方移除支持导致的硬性兼容中断。
apm install project-manager 为什么总失败？
报错类似 No available version compatible with your Atom version，本质是 Atom 官方在 1.60 版本中移除了对 project-manager 所依赖的底层 API 支持，该插件自 2023 年起停止维护，所有新版本 Atom（包括当前 2026 年的最新版）均不兼容。
- 运行
atom --version确认版本：若 ≥ 1.60，apm install project-manager必然失败，不用反复重试 - 降级到 1.59.x 虽技术上可行，但存在安全更新终止、其他插件大面积报错、Node.js 运行时不匹配等连锁风险
- 不要尝试用
--compatible参数绕过校验，该参数只筛选兼容包，而project-manager已无任何兼容版本存在
替代方案：用内置 Project Viewer 或 project-plus
Atom 自 1.60 起内置了轻量级项目管理能力，project-plus 是目前最活跃维护的第三方替代，二者都无需额外监听文件系统，规避了 macOS 权限和 Linux inotify 限制问题。
- 内置方案：按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Project: Add Project Folder即可添加项目；Project: Reveal in Finder可快速定位当前项目根目录 -
project-plus安装：终端执行apm install project-plus，它支持快捷键切换项目、项目分组、自动保存/恢复会话，且适配所有 1.60+ 版本 - 避免再碰
projects.cson：旧配置文件仍会被读取，但修改后不会生效，反而可能拖慢启动（尤其含错误路径时）
如果非要保留 projects.cson 配置怎么办？
你不能靠它驱动项目列表，但可以手动维护一份路径清单供快速跳转——前提是严格遵循 CSON 语法，且路径必须真实存在、不含符号链接循环或超大目录。
- 文件位置：
~/.atom/projects.cson（macOS/Linux）或%USERPROFILE%\.atom\projects.cson（Windows） - title 字段不可省略，必须用英文半角引号包裹，例如
title: "my-web-app" - 路径含空格或中文，必须加引号：
path: "/Users/me/My Projects/web"→ 正确写法是path: "/Users/me/My Projects/web" - 绝对禁止指向
node_modules、~/Downloads或任何实时生成大量文件的目录，否则 Atom 启动时会卡死数秒
真正麻烦的不是装不上，而是误以为“只要权限开足、cson 写对就能跑起来”——project-manager 的核心逻辑已被删掉，剩下的只是个空壳。现在能用的项目管理，要么走官方内置路径，要么靠 project-plus 补位，别在废弃包上浪费调试时间。
