apm install 失效因 path 未配置：macos 运行 atom --install-shell-commands，windows 重装时勾选“add to path”或手动添加路径，linux 将 apm/bin 加入 $path；国内网络需换源为 https://registry.npm.taobao.org/；插件异常需检查内置 node 版本并用 apm rebuild；导出清单用 apm list --installed --packages --bare。
apm install 命令不生效，提示 command not found
这是因为 apm 没进系统 PATH，Atom 安装时默认不自动配置。macOS 和 Windows 的 GUI 启动方式（双击图标）不会继承 shell 的环境变量，所以终端里能用的 apm，在 Atom 内部或桌面快捷方式启动后就找不到。
- macOS：运行
atom --install-shell-commands（需先通过终端启动 Atom），之后重启终端 - Windows：重装 Atom 时勾选 “Add to PATH” 选项；若已安装，可手动把
C:\Users\{user}\AppData\Local\atom\app-{version}\resources\app\apm\bin加进系统环境变量 - Linux：确认安装的是官方 .deb/.rpm 包，或从
https://github.com/atom/atom/releases下载带apm的完整包，解压后将atom/app/apm/bin路径加入$PATH
插件搜不到或安装失败：网络和源的问题
Atom 默认用 npm registry，但国内直连经常超时或返回空列表，apm search 无结果、apm install 卡住或报 ENOTFOUND 都是典型表现。
- 临时换源：运行
apm config set registry https://registry.npm.taobao.org/（注意不是npm config，apm 有自己的配置） - 验证是否生效：执行
apm config get registry，输出应为刚设的地址 - 某些插件（如
atom-ide-ui）依赖 GitHub release，若被拦截，可手动下载.cson或.json元数据文件放到~/.atom/.apm/_cache对应路径下绕过请求
装完插件没反应，或报错 “Cannot find module”
Atom 插件分 CoffeeScript（旧）、JavaScript（新）和原生模块三类，Node.js 版本不匹配会导致 require 失败，尤其在 macOS 升级或 Windows 换 Node 后常见。
- 检查 Atom 内置 Node 版本：打开 DevTools（
Ctrl+Shift+I），输入process.versions.node，通常是 12.x 或 14.x（取决于 Atom 版本） - 不要用系统全局 Node 编译插件——
apm自带独立 Node 和 npm，所有编译必须走apm install或apm rebuild - 如果插件含原生模块（如
spell-check用到node-spellchecker），运行apm rebuild强制重编译，而不是npm rebuild
想批量安装插件，但 apm list --installed 输出格式难解析
apm list --installed 默认带 ASCII 表格和颜色控制符，直接 pipe 给 cut 或 awk 会出错；而 --packages 参数只输出包名，但不含版本，无法精确复现环境。
- 导出可重装的清单：用
apm list --installed --packages --bare > packages.txt，得到纯包名列表 - 还原时逐行安装：写个简单循环
while read p; do apm install "$p"; done - 注意：部分插件（如
platformio-ide）依赖其他插件或外部工具，单纯apm install不保证开箱即用，得看插件文档里的前置条件
插件的 node_modules 是软链接到 ~/.atom/.apm 的缓存目录，删 ~/.atom/packages/xxx/node_modules 没用；真正要清理得用 apm clean，否则重装可能复用损坏的缓存。
