apm config set registry 必须单独配置为 https://registry.npm.taobao.org/，不继承 npm 配置；设完需验证 apm config get registry 输出正确，并执行 apm install --check 确认就绪。
apm config set registry 必须单独配置，不读取 npm config
Atom 的 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 + apm install 手动兜底
当换源、清缓存、重编译全无效，或插件根本不在官方仓库（比如只在 GitHub 上发布），就得绕过 apm：
- 进
~/.atom/packages（Windows 是%USERPROFILE%\.atom\packages） - 用
git clone下载插件仓库到该目录下（例如git clone https://github.com/atom/atom-beautify.git） - 进入插件目录，运行
apm install（不是npm install，除非插件明确支持） - 确保插件文件夹名就是包名（如
atom-beautify），不能多套一层父目录
手动安装最常踩的坑是路径放错、多了一层解压目录、或 Atom 后台进程没杀干净——这些都会导致插件“存在但不工作”。
