离线安装atom插件失败主因是未执行apm install --production构建，导致缺少node_modules；必须在与目标机完全一致的atom版本下构建，且本体须用官方deb/rpm/msi包安装。
离线安装 Atom 插件包失败，大概率不是路径放错了，而是没走完 apm install --production 构建流程——插件目录里缺 node_modules，Atom 启动时根本加载不了。
为什么直接复制 GitHub 源码包会报 Cannot find module 'season'
GitHub 上下载的插件仓库（如 https://github.com/AtomLinter/linter-gcc）是源码，不含 node_modules；Atom 不会在启动时自动执行依赖安装，它只加载已构建完成、可直接 require 的模块。常见错误现象包括：
- 重启 Atom 后插件不显示在 Settings → Install 页面
- 开发者工具（
Ctrl+Shift+I）控制台报Error: Cannot find module 'fs-plus'或Failed to activate package 'xxx' - 插件文件夹里只有
lib/、src/、package.json，但没有node_modules目录
必须用 apm install --production，不能用 npm install
apm 和 npm 解析 package.json、处理 engines.atom、执行 postinstall 脚本的方式完全不同。用 npm install 会漏掉 Atom 特定构建步骤，尤其对含原生模块的插件（如 linter-gcc）必然失效。正确做法是：
- 在与目标离线机**完全一致版本**的 Atom 下操作（例如目标机是
v1.69.0，构建机也必须是v1.69.0） - 运行
apm install --production linter-gcc（--production关键：跳过devDependencies，减小体积且避免构建失败） - 进入
~/.atom/packages/linter-gcc，确认存在node_modules，且里面有gcc、atom-linter等子目录 - 整个文件夹打包（含
node_modules），再拷到离线机对应位置
哪些插件根本不能离线用
三类插件即使把 node_modules 完整拷过去，离线环境下也必然失败：
- 依赖实时 API：如
autocomplete-atom-api（需连 GitHub 获取最新文档）、platformio-ide（启动强制校验云端 toolchain） - 含动态下载逻辑：如某些
language-rust版本首次启用时拉取语法定义文件 - 需要全局
apm运行时支持：如sync-settings（本质包装了apm login和apm publish）
这类插件控制台通常报 Failed to fetch https://... 或卡在初始化阶段，无法绕过。
离线机装完插件不生效？先看控制台报错
别凭“文件夹存在”就认为装好了。打开开发者工具（Ctrl+Shift+I），切到 Console 标签页，重点查这几条线索：
-
Error: Cannot find module 'fs-plus'→package.json缺失，或"main"字段指向不存在的入口文件 -
Failed to activate package 'autocomplete-python' because it depends on 'language-python@^0.50.0'→ 前置依赖未安装，需一并离线部署language-python -
Cannot read property 'onDidStopChanging' of undefined→ 插件构建时 Atom 版本不匹配（比如用 v1.72.0 构建的插件装到 v1.69.0 离线机）
真正麻烦的不是复制文件，而是每个插件对激活时机、依赖粒度、构建产物结构的要求都不一样——autocomplete-python 靠语法包触发，go-plus 得调外部 gopls 二进制，离线前最好先在有网机器上跑通 apm test 确认它到底要什么。
