project-manager 在 atom 1.60+ 中彻底不可用,因其依赖的底层 api(如 atom.project.addpath)已被移除且插件停止维护;应改用兼容的 project-plus 插件实现多根工作区管理。

project-manager 在 Atom 1.60+ 版本中已彻底不可用,强行安装会报错 No available version compatible with your Atom version。这不是配置问题,是底层 API(如 atom.project.addPath)已被移除,插件本身停止维护。如果你当前 Atom 版本 ≥ 1.60(运行 atom --version 可确认),请直接跳过安装步骤,改用兼容方案。
为什么 project-manager 安装失败?
常见错误现象:apm install project-manager 执行后提示兼容性失败,或 Settings → Install 搜索不到该包。
- 根本原因:Atom 官方从 1.60 版起删除了对旧式项目管理 API 的支持,
project-manager依赖这些 API 启动和监听路径,无法绕过 - 降级 Atom 到 1.59.x 不可行:安全更新已终止,且大量现代插件(如
tree-sitter语法高亮)将无法加载 - 手动编辑
projects.cson无效:文件即使存在,Atom 1.60+ 也不会读取它来还原工作区
替代方案:用 project-plus 实现多根工作区
project-plus 是目前唯一轻量、稳定、真正适配 Atom 1.60+ 的项目管理插件,不依赖文件系统监听,配置简单,无 cson 手动维护风险。
- 安装命令:
apm install project-plus(macOS 用户若提示apm: command not found,先在 Atom 菜单中执行Atom > Install Shell Commands) - 添加项目:Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Win/Linux)→ 输入
Project Plus: Add Project Folder,选中目录即可 - 保存工作区组合:调出命令面板 →
Project Plus: Save Workspace,输入名字(如my-python-env),它会把当前所有已添加的根目录存为一个快照 - 切换工作区:
Project Plus: Switch Workspace,选择名字后立即加载全部路径 + 已打开文件(不含面板位置,但保留 tab 顺序)
projects.cson 文件现在还有用吗?
没有。Atom 1.60+ 完全忽略该文件。如果你发现 ~/.atom/projects.cson 存在,建议重命名备份(如 projects.cson.bak),避免误编辑引发启动卡死。
- 该文件是 CSON 格式,不是 JSON;一个全角空格或中文引号就可能导致 Atom 启动停滞
- 哪怕 Atom 版本较低,也别往里面硬塞
node_modules或~/Downloads这类超大目录——监听开销会拖慢整个编辑器 -
project-plus的工作区数据存在~/.atom/storage/project-plus-workspaces.json,纯 JSON,可读可查,但一般无需手动干预
macOS 权限和 Windows 杀软会影响项目管理吗?
对 project-plus 不影响。它不使用 chokidar 监听文件变化,所以完全规避了 macOS「完全磁盘访问」拦截、Windows 杀软静默阻止、Linux inotify 限制等问题。
- 旧版
project-manager卡在「项目列表不刷新」,大概率就是权限被拦;而project-plus只在你主动触发时读取路径,无后台监听 - 如果用的是官方内置 Project Viewer(Cmd+Shift+P →
Project: Add Project Folder),它也不监听,但不支持「保存/切换工作区组合」,仅单项目管理
project-plus ——其他方案要么失效,要么需要你妥协功能。










