apm config set registry 必须单独配置，不读取npm config；国内直连官方源不可用，需设为https://registry.npm.taobao.org/并执行apm install --check验证；.apmrc路径与格式严格，插件不加载多因Node版本不匹配，须apm rebuild重编译。
apm config set registry 必须单独配，不读 npm config
国内直连 https://registry.npmjs.org/ 和 https://atom.io/api 基本不可用，apm install 卡在 “fetching…” 或几秒后报 ENOTFOUND / ETIMEDOUT，就是源没换对。注意：apm 完全不继承系统 npm config，改 npm config set registry 无效。
正确命令只有这一条：
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：文件放在
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下载插件源码到该目录下（如git clone https://github.com/atom/autocomplete-plus.git） - 进入插件目录，执行
npm install（推荐用cnpm install加速） - 关闭 Atom，重新打开
注意：某些插件依赖特定 npm 版本（如 node 8+ 的 package-lock.json 冲突），可降级为 npm install -g npm@4.2.0 后再装。
最常被忽略的一点：插件是否真需要？很多“必备”插件其实只在特定场景触发初始化（比如 linter-eslint 在首次打开 JS 文件时才拉起 Node 子进程），盲目堆砌反而让启动和编辑都变慢。
