apm install卡在“fetching…”是因国内直连https://registry.npmjs.org/和https://atom.io/api超时或ENOTFOUND；apm不读npm config，必须单独执行apm config set registry https://registry.npm.taobao.org/并验证生效，再运行apm install --check确认就绪。
apm install 为什么总卡在 fetching…
国内直连 https://registry.npmjs.org/ 和 https://atom.io/api 基本不可用，apm install 不会报明确错误，而是停在 “fetching…” 几秒后直接超时或返回 ENOTFOUND。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 极易出错——路径要对（Windows 是 %USERPROFILE%\.atom\.apmrc，macOS/Linux 是 ~/.atom/.apmrc），内容只能是两行、无空行、无 BOM、无中文标点：
registry=https://registry.npm.taobao.org/ strict-ssl=false
别写 proxy 或 https-proxy 字段：apm 对代理支持极弱，换源比配代理可靠十倍。
装完插件却没反应，是不是安装失败了
不是。插件显示“已启用”但语法高亮不生效、快捷键失灵、右下角 grammar 显示 Plain text，大概率是 Node 版本不匹配，而非安装失败。
Atom 自带独立 Node（当前主流为 v12.x / v14.x / v20.x），不走系统 Node。打开 DevTools（Ctrl+Shift+I），输入 process.versions.node 查看实际版本。
若插件含原生模块（如 spell-check、term3），必须重编译：
- 关掉所有 Atom 窗口（包括后台进程）
- 运行
apm rebuild—— 这会强制用当前 Atom 内置 Node 重新编译所有包 - 若报
zlib错误或EACCES，先apm clean再重来 - 绝对不要用
npm rebuild：它调的是系统 Node，对 Atom 完全无效
Mac 用户注意：atom 从 Dock 启动和终端 atom 命令启动，环境变量可能不同，建议统一用终端方式复现问题。
想装的插件 apm list 找不到，或装的是旧版
apm 默认从 https://atom.io/packages 拉包，但该仓库自 2022 年起基本停止同步——大量插件新版本只发布在 GitHub Release 页面，未推送到 atom.io。
例如：
-
file-icons：运行apm install file-icons装的是停更分支；必须指定兼容版：apm install https://github.com/file-icons/atom/releases/download/v2.1.45/file-icons-2.1.45.tgz -
platformio-atom-ide-terminal：官方已弃用，推荐迁移到term3或 VS Code；若坚持用，只能找社区 fork 的兼容版手动安装
排查方法：
- 运行
apm outdated看哪些插件有更新但没被拉下来 - 逐个查其 GitHub repo 的
Releases页面 - 用
apm list --installed --packages检查每个包的engines.atom字段是否满足当前 Atom 版本（如>=1.60.0）
Atom v1.60+ 升级到 Electron 25 / Node 20，导致大量旧插件静默失效——不是报错，而是根本不加载。
手动安装插件时文件夹放哪、怎么验证
手动安装 = 把插件代码放到 Atom 扫描路径里：~/.atom/packages（macOS/Linux）或 %USERPROFILE%\.atom\packages（Windows）。关键不是“解压”，而是“路径精准”。
常见错误：
- 把插件文件夹拖进
~/.atom根目录，Atom 完全无视 - 下载的是
xxx-master.zip，解压出来是xxx-master/，应直接把整个xxx-master文件夹复制进packages/，别再套一层 - Windows 用户用了 OneDrive 或 iCloud 同步目录，导致
.atom实际在云盘路径，而 Atom 启动时读的是本地路径
验证是否放对：
- 进 Atom → Settings → Packages，搜索插件名，状态应为
Enabled - 打开一个对应语言文件（如
.py），或按Ctrl+Shift+L手动设置 grammar，确保右下角显示正确语言 - 检查插件目录下
package.json中"main"字段是否指向真实存在的入口文件（如"main": "./lib/main.js"）
如果插件依赖 node_modules，进该目录后可运行 apm install 或 npm install（前提是插件支持）；但优先用 apm install，它会调用 Atom 自带的 npm。
