apm install卡住主因是网络代理无效，正确解法为换源至https://npmmirror.com、执行apm clean清缓存、再重试安装；装完不生效需查devtools报错，常见因node版本不匹配或缺node_modules。
apm install 卡住，90% 是网络代理没走对
Atom 的 apm 不读系统环境变量（如 HTTP_PROXY），也不走 Windows 代理设置，它用的是自己内置的证书链和 DNS 解析逻辑。国内直连 https://atom.io 和 GitHub API 基本超时或 TLS 握手失败。
临时解法是关掉杀毒软件的 HTTPS 扫描（尤其是 360、腾讯电脑管家），它们会中间人劫持并替换证书，导致 apm 拒绝连接；长期解法是换源 + 清缓存：
- 运行
apm config set https-proxy https://registry.npm.taobao.org（无效，apm不认这个配置） - 正确做法：改 registry 源为镜像站，执行
apm config set registry https://npmmirror.com - 再跑
apm clean清掉损坏的 zlib 缓存，否则后续所有操作都会卡在zlib: unexpected end of file - 最后重试
apm install linter-gcc，别用 GUI 点 Install —— 界面不报错但后台静默失败
装完了不生效？先看 DevTools 控制台报什么
插件显示“已启用”，但快捷键没反应、语法高亮不出现，不是安装失败，而是模块加载中断。打开 Ctrl+Shift+I → Console 标签页，盯住第一行错误：
-
Error: Cannot find module 'season'→ 插件根目录缺package.json，或"main"字段指向了不存在的文件（比如写成./lib/main.js，实际是./src/main.js） -
Failed to activate package 'autocomplete-python'→ 依赖没装全，常见于跳过了apm install --production直接拷源码 -
Cannot read property 'onDidStopChanging' of undefined→ Atom 版本不匹配，比如在 v1.72 构建后迁移到 v1.69 环境
离线安装必须用 apm install --production，npm install 完全无效
GitHub 下载的 autocomplete-python-2.1.0.zip 只有源码，没有 node_modules，Atom 启动时不会自动 npm install。直接解压扔进 ~/.atom/packages/，必然白屏或报错。
正确路径只有一条：在与目标机**完全一致 Atom 版本**（例如都是 v1.69.0）且**本体安装正确**（Windows 必须是 AtomSetup-x64.exe，不是 zip）的机器上执行：
apm install --production autocomplete-python- 进
~/.atom/packages/autocomplete-python/确认存在node_modules文件夹，且里面有atom-languageclient、fs-plus等子目录 - 整个插件文件夹（含
node_modules）打包迁移，不要只复制src/或lib/ - 禁用
npm install：它不校验engines.atom字段，也不调用 Atom 专用的node-gyp路径，原生模块（如linter-gcc）必然缺失可执行文件
有些插件离线后注定不能用，别白费力气
三类插件在断网环境下必然失效，拷全了 node_modules 也没用：
- 依赖实时 API 的：
autocomplete-atom-api（启动时拉 GitHub 文档）、platformio-ide（强制校验云端 toolchain） - 含动态下载逻辑的：
language-rust某些版本首次启用会 fetch rustc 语法定义，控制台持续报Failed to fetch https:// - 需要全局
apm运行时支持的：sync-settings本质是包装了apm login和apm publish，离线机从未连过服务器就无法初始化
这类插件一旦出现在离线环境，控制台会卡在 loading 阶段或反复报 fetch 错误——不是构建错了，是设计上就不支持离线。
