Atom插件管理需结合GUI与apm命令:Settings→Packages查看已安装插件,apm list可导出完整清单;插件未生效多因加载失败,需查开发者工具报错;sync-settings备份的是列表而非文件,忽略配置或拼写错误会导致还原失败。

在 Settings → Packages 页面直接查看
打开 Atom 后按 Cmd+,(macOS)或 Ctrl+,(Windows/Linux),进入设置界面,点击左侧的 Packages 标签页。页面顶部会显示「Installed Packages」,下方列表就是当前所有已安装插件(含 Atom 自带的默认包)。默认加载的是全部启用/禁用状态的插件,可通过右上角排序按钮切换按「启用时间」「名称」或「作者」排列。
用 apm 命令行导出完整清单
GUI 页面只展示基础信息,真要确认具体版本、路径或排查冲突,得靠命令行:
-
apm list --installed --packages:只列出用户手动安装的插件名和版本(不含 Atom 内置包) -
apm list --packages:列出所有包(含内置 + 用户安装),更全 -
apm list --installed --themes:单独查已安装主题
注意:apm 命令依赖 Node.js 环境,若提示 command not found,说明 Atom 未正确注册全局命令,需重装或手动添加 ~/.atom/bin(macOS/Linux)或 %USERPROFILE%\.atom\bin(Windows)到系统 PATH。
为什么有些插件在列表里却没生效?
常见原因不是没装,而是没加载成功:
- 插件的
package.json中main字段指向错误路径,Atom require 失败 - 用了不兼容语法(如顶层
await、import.meta),Node.js 在加载阶段就抛错,根本进不了激活流程 - 插件依赖的本地模块编译失败,比如报
Module version mismatch,此时需运行apm rebuild
验证是否真的加载失败:打开开发者工具(Window: Toggle Dev Tools),切到 Console,刷新 Atom,看有没有 Failed to activate package 'xxx' 这类报错——这才是第一手线索。
sync-settings 备份时漏掉插件?先确认它是否在列表里
sync-settings 备份的是「已安装插件列表」本身,不是插件文件。如果某插件出现在 apm list 输出中,但 Restore 后没自动装上,大概率是:
- 该插件被
sync-settings的ignoredPackages配置项排除了(检查~/.atom/config.cson里的syncSettings段落) - Gist 中保存的插件清单 JSON 被手动编辑过,格式损坏导致解析失败(可打开对应 Gist URL 直接查看原始内容)
- 插件名拼写错误,比如把
linter-eslint写成linter-eslints,sync-settings不会报错,只会静默跳过
真正容易被忽略的点是:插件列表存在 ≠ 插件能用;列表为空 ≠ 没装插件——可能只是 Atom 没读到它们。

















