atom 1.58+ 内置project viewer功能,非插件,无需安装;支持多根项目添加与切换,但重启后丢失,持久化需project-plus等插件。

Atom 没有叫 project-viewer 的插件,也不需要安装它——Project Viewer 是 Atom 1.58+ 内置功能,不是第三方包。
为什么搜不到 project-viewer 插件?
这是最常见的误解来源:网上教程常把内置功能误称为“project-viewer 插件”,甚至有人试图 apm install project-viewer,结果报错 Package not found。它根本不存在于 apm 仓库,也不是独立包。
- Project Viewer 是 Atom 核心的一部分,随编辑器一起发布,无需额外安装
- 它的命令前缀是
Project:(如Project: Add Project Folder),全部可通过Cmd+Shift+P/Ctrl+Shift+P调出 - 所有相关行为(树视图显示、
Cmd+P搜索范围、多根并列结构)都由 Atom 自身驱动,不依赖任何插件
Project: Add Project Folder 怎么实现“分组项目管理”?
Atom 不支持逻辑分组(比如把 A/B/C 归为“前端组”、D/E 归为“后端组”),但能通过多根工作区模拟分组效果——每个根目录就是一组的起点。
- 执行
Project: Add Project Folder(快捷键Cmd+Shift+O或Ctrl+Shift+O)添加第一个项目目录,它成为第一个根节点 - 重复该操作,添加第二个、第三个……每个都会作为独立顶层节点出现在树视图中,彼此平级,不嵌套
- 此时
Cmd+P搜索会覆盖所有已添加根目录下的文件,相当于“统一索引多个项目” - 切换焦点:用
Project: Switch Project命令可快速跳转到任一根目录顶部,光标自动落到该组下最近打开的文件
重启后项目全没了?这才是关键限制
Project Viewer 的“分组”是纯内存态的:关掉 Atom,所有根目录路径立即丢失,下次启动只剩最后一个添加的目录。这不是 bug,是设计如此。
- 想保留 A+B+C 这组分组?不能靠内置功能,必须用插件持久化
-
project-plus是目前唯一稳定适配 Atom 1.60+ 的方案:装完即用,Cmd+Alt+P切换,所有根目录状态存在内存里,关闭即清空,不写projects.cson,避免语法错误卡死启动 - 别碰
project-manager:它在 Atom 1.60+ 已彻底失效,报错No available version compatible是必然结果,不是权限或网络问题
多项目性能卡顿,往往和“分组”本身无关
树变慢、Cmd+P 卡、弹出 “heavy file” 警告,通常不是因为加了多个根目录,而是某个根目录里没排除大体积内容。
- 检查每个已添加的路径是否含
node_modules、dist、.git等目录;这些默认会被扫描,拖慢渲染和搜索 - 在
Settings → Core → Ignored Names中填入node_modules, dist, .git(逗号分隔,无空格) - macOS 用户还需确认 Atom 在「隐私与安全性 → 完全磁盘访问」里已被勾选,否则文件系统监听失效,导致某些插件(如旧版
project-manager)无法刷新列表
真正麻烦的从来不是怎么加项目,而是怎么让它们不互相干扰——忽略规则漏一条,整个分组就拖慢;重启后重加三遍,才是日常真实损耗。











