atom插件离线安装失败主因是未执行apm install --production构建，导致缺少node_modules、版本校验跳过或node环境不匹配；必须在与目标机完全一致的atom版本下用官方安装包运行该命令，且三类依赖实时api、动态下载或全局apm的插件无法离线使用。
Atom插件依赖安装报错，90% 不是插件本身有问题，而是 apm 没走完构建闭环——缺 node_modules、版本校验跳过、或 Node 环境不匹配导致模块 require() 失败。
为什么 npm install 不能替代 apm install --production
apm 和 npm 行为根本不同，强行混用会静默失败：
-
apm install会读取package.json中的engines.atom字段做版本校验，npm install完全忽略它 - 含原生模块（如
linter-gcc、language-rust）的插件，必须由apm调用 Electron 对应头文件和node-gyp路径，npm找不到这些资源 -
--production参数跳过devDependencies，避免离线机因缺 Python / 编译工具链卡在gyp ERR! - 直接复制 GitHub 源码进
~/.atom/packages/后不运行apm install --production，node_modules就是空的，Atom 启动时require('season')必然报Cannot find module
报 Cannot find module 'xxx' 或 Module version mismatch 怎么办
这不是代码写错了，是模块加载阶段就崩了，重点查 Node 环境和编译状态：
- 打开 Atom DevTools（
Ctrl+Shift+I），执行process.versions.node，确认当前 Atom 内置 Node 版本（如 v14.17.0） - 如果刚更新过 Atom，或装过含原生模块的插件，必须运行
apm rebuild（不是npm rebuild）——它强制用 Atom 自带 Node 重编译所有包 - 若
apm rebuild报zlib错误，说明缓存已损坏，先跑apm clean清空再重来 - Mac 用户注意：
从 Dock 启动 Atom和终端里 atom 命令启动的环境变量可能不同，PATH 不一致会导致某些模块找不到二进制依赖
离线环境下依赖报错，构建机和目标机必须完全同版本
Atom 插件不是“拷过去就能跑”，API 和生命周期钩子随版本变化：
- 离线机用的是
Atom v1.69.0，构建机也必须是v1.69.0—— 用v1.72.0构建的autocomplete-python移过去，会报Cannot read property 'onDidStopChanging' of undefined - Atom 本体必须用官方
.deb/.rpm/.msi包安装；解压版或非官方镜像版可能导致apm路径错乱，apm install根本调不起正确node-gyp - 构建完成后，务必进插件目录（如
~/.atom/packages/linter-gcc）确认node_modules存在，且里面含gcc、atom-linter等子目录——这才是可运行副本
哪些插件即使装了依赖也注定离线失败
三类插件在无网状态下无法绕过远程依赖，拷全 node_modules 也没用：
- 依赖实时 API 的：
autocomplete-atom-api（启动时拉 GitHub 文档）、platformio-ide（强制校验云端 toolchain） - 含动态下载逻辑的：
language-rust某些版本首次启用会fetchrustc 语法定义；spell-check的词典包初始化时尝试下载 - 需要全局
apm运行时支持的：sync-settings本质包装了apm login和apm publish，离线机从未连过服务器就无法初始化
这类插件装完重启，控制台必现 Failed to fetch https:// 或卡在 loading 状态——别浪费时间反复构建。
