apm config set registry 必须单独配置，不读取 npm config；国内直连官方源不可用，需设为 https://registry.npm.taobao.org/ 并执行 apm install --check 验证；.apmrc 路径与格式严格，插件不加载多因 node 版本不匹配，须 apm rebuild 重编译。
apm config set registry 必须单独配，不读 npm config
apm 不继承系统 npm 的配置，改 npm config set registry 完全无效。国内直连 https://registry.npmjs.org/ 和 https://atom.io/api 基本不可用，表现为 apm install 卡在 “fetching…”、几秒后报 ENOTFOUND 或 ETIMEDOUT。
正确做法是运行：
apm config set registry https://registry.npm.taobao.org/
验证是否生效：
apm config get registry
输出必须是刚设的地址，否则配置静默失败。改完后必须执行：
apm install --check
看到 Checking for native build tools done 才算真正就绪。
.apmrc 文件路径和格式极易出错
手动建 .apmrc 是常见操作，但 Windows/macOS/Linux 路径不同，且内容格式敏感，错一处就失效。
- 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 版本不匹配
插件显示“已启用”，但快捷键没反应、语法高亮不生效、面板打不开，不是安装失败，而是 Atom 内置 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 上发布），就得绕过 apm。
操作步骤：
- 进
~/.atom/packages（Windows 是%USERPROFILE%\.atom\packages） - 执行
git clone https://github.com/{owner}/{repo} - 进入该目录，运行
npm install - 重启 Atom 或按
Ctrl+Alt+R刷新
注意：npm install 依赖本地 Node 环境，但只要插件不含原生模块，通常能直接跑通；含原生模块仍需 apm rebuild 补救。
