apm换源必须单独配置，执行apm config set registry https://registry.npm.taobao.org/并验证生效，否则安装会超时失败；.apmrc文件需严格按路径和格式创建，且插件需用apm rebuild适配Atom内置Node。
换源是最快见效的解决方式，不换源就手动装，等于在泥地里换轮胎。
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 是常见但高危操作——路径错、换行错、空格错、BOM 错，都会让配置失效。
- 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下载插件源码到该目录下 - 进入插件子目录，执行
npm install（推荐用cnpm install加速） - 重启 Atom 或按
Ctrl+Alt+R刷新
注意：npm install 必须在插件目录内执行，且 Atom 必须完全退出后再启动，否则模块不会被识别——这是最常被忽略的一步。
