Atom插件安装超时主因是apm无法访问默认源，需用apm config set registry换源；apm不继承npm配置，必须单独设置；换源后需运行apm install --check验证构建工具链，并用apm rebuild适配Atom内置Node版本。
国内网络环境下，Atom 插件安装超时不是网络慢，而是 apm 默认连不上 registry.npmjs.org 和 atom.io/api —— 换源是唯一有效解法，配代理基本无效。
apm config set registry 必须单独执行，不继承 npm 配置
很多人改完 npm config set registry 就以为生效了，其实 apm 完全不读这个配置。它只认自己那一套，且必须用 apm config 命令写入。
- 运行
apm config set registry https://registry.npm.taobao.org/ - 立刻验证：
apm config get registry输出必须是刚设的地址，否则配置静默失败（常见于权限不足或路径被重定向） - Windows/macOS/Linux 下该配置都写入
~/.atom/.apmrc，但不要手动建——命令会自动处理格式和路径
换源后必须运行 apm install --check
只改 registry 不够，apm 还要校验本地构建工具链是否就绪。卡在 “fetching…” 或报 ENOTFOUND/ETIMEDOUT，往往是因为这步没过。
-
apm install --check成功输出Checking for native build tools done才算真正可用 - 若失败，大概率是系统缺 Python 2.7 或 Visual Studio Build Tools（Windows）、Xcode Command Line Tools（macOS）
- Linux 用户注意：
apm依赖python2命令，部分发行版默认只有python3，需建软链接或装python2包
插件装上了却不生效？先看 Atom 内置 Node 版本
显示 “Installed” 但快捷键没反应、语法高亮不出现，90% 是因为插件含原生模块（如 spell-check、term3），而 Atom 自带的 Node（v12.x/v14.x）和你系统 Node 不一致，导致 require 失败。
- 打开 DevTools（
Ctrl+Shift+I），输入process.versions.node看实际版本 - 关掉所有 Atom 进程（包括后台），再运行
apm rebuild—— 它会强制用 Atom 内置 Node 重编译全部包 - 若报 zlib 错误，说明缓存损坏，先
apm clean再apm rebuild
彻底卡死时，绕过 apm 直接 clone + npm install
当换源、clean、rebuild 全无效，或者插件只在 GitHub 发布（没上 atom.io），就得手动构建。关键点是：必须在与目标机**完全同版本**的 Atom 下操作。
- 进
~/.atom/packages（Windows 是%USERPROFILE%\.atom\packages） git clone https://github.com/xxx/plugin-name.git-
cd plugin-name && npm install --production（--production不装 devDependencies，避免构建失败） - 确认目录下有
node_modules且含插件所需子模块（如linter-gcc里要有gcc和atom-linter）
最易忽略的是：Atom 已于 2022 年底停更，v1.60.0 是最后一个稳定版。现在用的所谓“新版 Atom”，很多是第三方打包残留，apm 的证书链或 registry 接口早已失效——这种情况下，换源也救不了，只能降级到官方 v1.60.0 或转向 VS Code。
