apm install 报 enotfound 或超时是因默认 registry 被拦截，需单独配置 apm 源为 https://registry.npm.taobao.org/ 并执行 apm install --check 验证；代理配置易错，应严格按路径和格式写 .apmrc；插件不加载多因 node 版本不匹配，须用 apm rebuild 重编译；彻底失效时可 git clone + npm install 手动安装。
apm install 报 ENOTFOUND 或超时，本质是 registry 不可达
国内直连 registry.npmjs.org 基本不可用，apm search 返回空、apm install 卡在 “fetching…” 或几秒后报 ENOTFOUND、ECONNRESET、ETIMEDOUT，都是典型表现。这不是插件问题，也不是你网络断了，而是 apm 默认源被拦截。
关键点：apm 不读系统 npm config，必须单独配它的源：
- 运行
apm config set registry https://registry.npm.taobao.org/（注意不是npm config） - 验证是否生效：
apm config get registry，输出应为刚设的地址 - 改完后务必执行
apm install --check，看到Checking for native build tools done才算真正就绪
代理配置失败？别碰 .apmrc 文件路径和格式
手动建 .apmrc 是常见操作，但极易出错——路径错、文件名错、内容格式错都会让配置静默失效。
正确做法：
- Windows：在
C:\Users\{用户名}\.atom\.apmrc（注意是.atom目录下，不是.atom/.apm子目录） - macOS/Linux：在
~/.atom/.apmrc - 文件内容严格两行，无空行、无 BOM、无中文标点：
registry=https://registry.npm.taobao.org/ strict-ssl=false
- 不要写成
https-proxy或proxy字段——apm 对代理支持极弱，优先换源而非配代理
装完插件不加载？Node 版本不匹配导致 require 失败
插件显示“已启用”，但快捷键没反应、语法高亮不生效、面板打不开，大概率不是安装失败，而是内置 Node 运行时不认模块。
Atom 自带独立 Node（v12.x 或 v14.x），不走系统 Node。检查方式：打开 Atom DevTools（Ctrl+Shift+I），输入 process.versions.node。
若插件含原生模块（如 spell-check、term3），必须重编译：
- 先关掉所有 Atom 窗口（包括后台进程）
- 运行
apm rebuild—— 这会强制用当前 Atom 内置 Node 重新编译所有包 - 不要用
npm rebuild，它调的是系统 Node，完全无效 - 若
apm rebuild报 zlib 错误，说明缓存已损坏，先跑apm clean再重来
彻底卡死时，用 git clone + npm install 手动兜底
当换源、清缓存、重编译全无效，或插件根本不在官方仓库（比如 GitHub 上未发布到 atom.io），就得绕过 apm。
步骤极简，且不依赖网络稳定性：
- 进
~/.atom/packages（Windows 是C:\Users\{user}\.atom\packages） - 用
git clone https://github.com/{owner}/{repo}.git拉源码（例如git clone https://github.com/emmetio/emmet-atom.git） -
cd emmet-atom && npm install—— 注意这里用的是系统 npm，不是 apm - 重启 Atom 或按
Ctrl+Alt+R刷新
这个方法跳过了 apm 的 registry 请求、依赖解析、权限校验三层链路，是最可靠的 fallback。但要注意：手动装的插件不会出现在 Settings → Install 页面里，更新也得自己 git pull && npm install。
