Atom插件下载失败主因是apm无法访问默认registry或Node版本不匹配，应先执行apm config set registry https://registry.npm.taobao.org/换源并运行apm install --check验证，再通过apm rebuild重编译插件以适配Atom内置Node，若仍无效可手动git clone至.atom/packages目录并npm install。
Atom 插件下载失败，90% 以上不是插件问题，而是 apm 拿不到可用 registry 或本地构建环境不匹配。直接换源 + 重编译，基本能解决所有卡在 “fetching…”、ENOTFOUND、E500、zlib: unexpected end 的情况。
apm install 卡住或报 ENOTFOUND / ETIMEDOUT
这是国内最常见现象，apm 默认直连 registry.npmjs.org，但该域名在国内基本不可达——不是你网络断了，是请求根本发不出去。
- 别改
npm config，apm不读它；必须单独配apm的源：apm config set registry https://registry.npm.taobao.org/ - 验证是否生效：
apm config get registry，输出应为刚设的地址 - 改完必须运行
apm install --check，看到Checking for native build tools done才算真正就绪 - 如果仍超时，检查
.atom/.apmrc文件是否存在且格式正确（两行、无 BOM、无空格、路径严格在.atom目录下）
装完插件不生效：快捷键没反应、语法高亮失效
显示“已启用”但功能全无，大概率是 Atom 内置 Node 版本（如 v12.x）和插件原生模块不兼容，require 直接失败，控制台可能静默报错。
- 先关掉所有 Atom 窗口（包括后台进程），再执行
apm rebuild—— 这会强制用 Atom 自带 Node 重编译所有插件 - 不要用
npm rebuild，它调的是系统 Node，完全无效 - 若
apm rebuild报zlib错误，说明缓存损坏，先跑apm clean清掉.atom/packages和.atom/.apm，再重来 - 某些插件（如
linter）依赖配套 UI 包（如linter-ui-default），得手动补装：apm install linter-ui-default busy-signal
手动安装：绕过 apm 直接 git clone + npm install
当换源、重编译都失败，或插件未发布到 atom.io（比如只在 GitHub 有 repo），就得走手动路径。注意路径和命名必须规范，否则 Atom 根本识别不了。
- 进入
.atom/packages目录（Windows：C:\Users\{用户名}\.atom\packages；macOS/Linux：~/.atom/packages） - 用
git clone https://github.com/xxx/xxx.git下载源码（注意 URL 用git协议而非https，避免代理干扰） - 进到插件目录，运行
npm install（确保已装 Node.js，且版本不低于插件要求；Atom 自带 Node 不参与此步） - 插件文件夹名必须与
package.json中的name字段一致，比如"name": "activate-power-mode"→ 文件夹名必须是activate-power-mode - 重启 Atom，或用
Ctrl+Alt+R刷新
最易被忽略的一点：Atom 启动时会跳过损坏或初始化失败的插件，但不会报错提示。如果你反复试了换源、重编译、手动装，仍无效，临时重命名整个 .atom 目录，再启动 Atom —— 如果这时插件突然正常了，说明你原来的配置或缓存已损坏，不能只清 .apm，得整个重建。
