apm install 报 ENOTFOUND 或超时是因默认 registry 被拦截，需单独配置 apm 源为 https://registry.npm.taobao.org/ 并验证生效，同时注意 .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/<br>strict-ssl=false
- 不要写成
https-proxy或proxy字段——apm对代理支持极弱，优先换源而非配代理
插件显示“已启用”但功能不生效，大概率是 Node 版本不匹配
插件显示“已启用”，但快捷键没反应、语法高亮不生效、面板打不开，大概率不是安装失败，而是内置 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 手动兜底
当 apm install 和 apm rebuild 都失败，且插件又必须用，可跳过 apm 流程直接手动安装：
- 进入
~/.atom/packages（macOS/Linux）或C:\Users\{用户名}\.atom\packages（Windows） -
git clone https://github.com/{owner}/{repo}.git（例如git clone https://github.com/file-icons/atom.git） - 进入刚 clone 的目录，运行
npm install（注意：这里用的是系统npm，但只负责依赖安装；实际运行仍由 Atom 内置 Node 加载） - 重启 Atom，插件通常能加载
这个方法绕过了 apm 的 registry 请求和构建链，但要求你本地有 Git 和 Node/npm 环境；手动安装后，apm list 不会显示该插件，后续更新需自行 git pull + npm install。
