apm install 报 ENOTFOUND 或卡在 fetching…是因默认 registry 被拦截，需单独执行 apm config set registry https://registry.npm.taobao.org/ 并运行 apm install --check 验证；Windows 下 command not found 需手动添加 apm/bin 到系统 PATH；插件不生效须用 apm rebuild 重编译，手动安装则需 git clone 至 .atom/packages 后 npm install 并手动启用。
apm install 报 ENOTFOUND 或卡在 fetching…
这是国内用户最常遇到的现象，根本不是网络断了，而是 apm 默认源 https://registry.npmjs.org/ 在多数地区不可达。所有表现——apm search 返回空、apm install 几秒后报 ENOTFOUND/ETIMEDOUT——都指向同一个原因。
必须单独为 apm 配置镜像源，它不读 npm config：
- 运行
apm config set registry https://registry.npm.taobao.org/ - 验证：执行
apm config get registry，输出应严格等于上面的地址 - 改完后务必运行
apm install --check，看到Checking for native build tools done才算真正就绪
Windows 上 apm 命令提示 command not found
GUI 启动的 Atom 不继承系统 PATH，所以双击图标打开后，终端里能用的 apm 在 Atom 内部或快捷方式启动时就找不到。
解决方法取决于安装方式：
- 重装 Atom 时勾选 “Add to PATH”（最稳妥）
- 若已安装，手动把路径加入系统环境变量：
C:\Users\{用户名}\AppData\Local\atom\app-{version}\resources\app\apm\bin - 不要依赖
atom --install-shell-commands（那是 macOS 的命令）
插件装完但没反应，DevTools 报 Cannot find module
Atom 自带独立 Node 运行时（通常是 v12.x 或 v14.x），和你系统装的 Node 完全无关。插件含原生模块（如 spell-check、term3）时，必须用 Atom 内置 Node 重新编译。
关键动作只有两个：
- 先彻底关闭所有 Atom 窗口（包括后台进程）
- 运行
apm rebuild—— 注意不是npm rebuild，后者调的是系统 Node，完全无效 - 若报 zlib 错误，说明缓存损坏，先
apm clean再apm rebuild
插件不在 atom.io 仓库，或换源后仍失败
当 GitHub release 被拦截、插件未发布到官方源、或 apm install 彻底无响应时，手动安装是唯一可靠路径。
步骤极简，但路径和顺序不能错：
- 进
~/.atom/packages（macOS/Linux）或C:\Users\{用户名}\.atom\packages（Windows） - 用
git clone https://github.com/xxx/xxx.git下载源码到该目录 -
cd进入刚克隆的插件文件夹，运行npm install（确保已装 Node） - 重启 Atom 或按
Ctrl+Alt+R刷新
容易被忽略的是：手动安装后，插件不会自动启用，得去 Settings → Packages 里手动 toggle 开关；另外，某些插件需打开对应类型文件（如 Markdown 文件）才能触发 activationHooks 加载。
