离线安装atom插件失败主因是未执行apm install --production构建，导致缺少node_modules及兼容性校验；必须在与目标机完全一致的atom版本下构建，且本体须用官方deb/rpm/msi包安装。
离线安装 Atom 插件失败，90% 是因为没运行 apm install --production，而不是路径放错或解压不全。
为什么直接复制 GitHub 源码包进 ~/.atom/packages 会报 Cannot find module 'season'
GitHub 上下载的插件源码（比如 git clone 或 Source code.zip）默认不含 node_modules。Atom 启动时不会自动执行依赖安装，它只加载已构建完成、含完整依赖树的目录。缺少 node_modules 就等于缺了所有 require 的模块——season、fs-plus、atom-linter 全都找不到。
- 别下 “Source code” 压缩包，要下 GitHub Releases 页里的
xxx-v2.14.0.zip（带版本号的二进制发布包） - 解压后必须重命名文件夹为纯插件名，例如把
linter-gcc-3.0.2改成linter-gcc（Atom 不识别带版本后缀的文件夹） - 检查该文件夹下是否存在
package.json，且其中"name"字段值与文件夹名完全一致（大小写敏感）
必须用 apm install --production，不能用 npm install
apm 和 npm 解析 package.json、处理 engines.atom 版本约束、执行 postinstall 脚本（如编译 native 模块）的逻辑完全不同。用 npm install 可能装上依赖，但 linter-gcc 仍调不动 gcc，minimap 也出不来渲染层。
- 在与目标离线机完全一致的 Atom 版本下运行命令，例如目标是
v1.69.0，就不能在v1.72.0环境里构建 - 务必加
--production参数：跳过devDependencies，避免装入测试工具、文档生成器等离线无用且易冲突的包 - 执行后进入插件目录，确认
node_modules存在，且里面包含插件实际引用的子模块（如node_modules/gcc、node_modules/atom-linter）
哪些插件根本没法离线用
不是所有插件都能靠拷文件解决。三类插件在离线环境下必然失败，即使 node_modules 完整、路径正确、激活无报错：
- 依赖实时 API 的：
autocomplete-atom-api（需连 GitHub 拉最新 API 文档）、platformio-ide（启动强制校验云端 toolchain） - 含动态下载逻辑的：
language-rust某些版本首次启用时会尝试拉取语法定义；atom-ide-ui会尝试连接https://端点 - 需要全局
apm运行时支持的：sync-settings本质是包装apm login和apm publish，离线机从未连过服务器就无法初始化
离线机重启后插件不生效？先看控制台报错
别凭“Settings → Install 里显示已安装”判断成功。打开开发者工具（Ctrl+Shift+I），切到 Console 标签页，真实线索都在这里：
-
Error: Cannot find module 'fs-plus'→package.json缺失，或"main"字段指向不存在的入口文件 -
Failed to activate package 'linter' because it depe...（截断）→ 依赖插件（如linter-ui-default）没一并离线安装 -
Cannot read property 'onDidStopChanging' of undefined→ 插件构建环境 Atom 版本与目标机不一致
真正麻烦的从来不是“怎么拷”，而是“拷什么”和“在哪拷”。一个插件是否离线可用，得看它有没有硬编码的网络调用、是否绕不开 apm 的构建链路、以及它的依赖图里有没有另一层网络依赖——这些细节，往往藏在 package.json 的 dependencies 和源码里的 fetch、require('https') 调用里。
