apm update卡在Fetching或超时，本质是默认registry（https://atom.io/api）被本地网络策略、防火墙或DNS污染阻断，非网速问题；需确认代理设置、换国内镜像源、清理残留node_modules并完全退出Atom后重试。

apm update 为什么卡在 Fetching 或超时

APM 更新缓慢不是网速问题，而是默认 registry https://atom.io/api 被本地网络策略拦截或 DNS 污染。现象是执行 apm update 后长时间无响应，或报 request to https://atom.io/api/packages/xxx failed, reason: connect ETIMEDOUT。

• 先确认代理是否真生效：apm config get https-proxy 输出应为完整 URL（如 http://127.0.0.1:7890），为空说明没设对
• 临时换国内镜像源：apm config set registry https://npmmirror.com/mirrors/atom
• 禁用 SSL 验证仅用于调试：apm config set strict-ssl false（不建议长期开启）
• 别信“重试几次就好”——超时本质是连接被阻断，不是临时抖动

更新特定插件却没反应？检查 Intentions 类插件是否已失效

某些插件（如 intentions）在 Atom ≥1.60 后彻底无法加载，apm update intentions 看似成功，实则静默失败：命令面板搜不到 intentions:show，快捷键 Ctrl+. 无响应。

• 该插件依赖的 atom-package-deps 和旧版 atom.commands.add API 已被 Electron v11+ 移除，官方仓库早已归档
• 降级 Atom 到 1.58 也不行——Node.js 14+ 兼容性断裂会触发 ERR_PACKAGE_PATH_NOT_EXPORTED
• 遇到这类插件，直接卸载：apm uninstall intentions，改用内置功能替代（如 editor:wrap-lines 或配置 emeraldwalk:run-command）

强制更新失败还报错？优先清理 node_modules 再重装

插件更新后功能异常、状态栏图标消失、快捷键失灵，常见原因是旧版 node_modules 残留导致模块加载冲突，尤其发生在 Atom 升级到 v1.63.1（Electron 25 / Node 20）之后。

• 别只跑 apm update --force——它不清理已有构建产物
• 先删包目录：rm -rf ~/.atom/packages/xxx（macOS/Linux）或 rd /s %USERPROFILE%\.atom\packages\xxx（Windows）
• 再重装：apm install xxx，新版 apm 会自动匹配兼容版本
• 若报 The module '.../binding.node' was compiled against a different Node.js version，必须走这一步，否则必崩

为什么更新完插件还是不生效？Atom 必须完全退出再重开

修改配置或更新插件后只关闭窗口，不杀进程，会导致新代码未加载、缓存未刷新、Node 子进程仍驻留——这是最常被忽略的操作盲点。

• macOS：Activity Monitor 中结束所有 Atom Helper 进程；Windows：任务管理器里结束 atom.exe 和 electron.exe
• Linux：用 pkill -f atom 彻底清空
• 已打开的大文件不会自动切换模式，哪怕你刚改了 core.largeFileMode: true，也得重新加载文件才能生效