离线安装atom插件必须用apm install --production在与目标机完全相同版本的atom中构建，否则因缺失node_modules、未执行postinstall脚本或版本不匹配导致插件不显示或报错。
离线安装 Atom 插件不是“复制粘贴就完事”，核心在于构建出带 node_modules 的可运行副本，且必须与目标机的 Atom 版本、本体安装方式完全一致。
为什么直接解压 GitHub 源码到 ~/.atom/packages 会失败
常见错误现象包括：插件不显示、控制台报 Error: Cannot find module 'season' 或 Failed to activate package 'linter-gcc'。根本原因有三个：
- GitHub 下载的是源码，不含
node_modules；Atom 启动时不会自动执行依赖安装 -
package.json中的"main"字段可能指向未构建的lib/main.js，而实际目录里只有src/或dist/ - 插件名文件夹与
package.json中的"name"值大小写不一致（尤其在 Windows 上易被忽略）
必须用 apm install --production 构建，不能只靠 npm install
apm 和 npm 行为差异极大：前者会触发 Atom 特定的 postinstall 脚本（如编译 native 模块、生成语法缓存），后者只会装 JS 依赖。例如 linter-gcc 若只 npm install，gcc 二进制调用会静默失败。
- 构建必须在与离线机**完全相同版本**的 Atom 下进行（如目标是
v1.69.0，就不能用v1.72.0构建） - 务必加
--production参数：跳过devDependencies，避免引入构建工具导致体积膨胀或兼容问题 - 构建完成后，进入插件目录确认存在
node_modules/gcc和node_modules/atom-linter子目录
哪些插件本质上无法离线使用
三类插件即使拷全了 node_modules 也会启动失败，控制台必现 Failed to fetch https:// 或卡在加载状态：
- 依赖实时 API 的：如
autocomplete-atom-api（需连 GitHub 获取最新 API 文档）、platformio-ide（启动强制校验云端 toolchain） - 含动态下载逻辑的：如某些版本的
language-rust，首次启用时拉取rustc语法定义 - 需要全局
apm运行时支持的：如sync-settings，本质包装了apm login和apm publish，离线机从未连过服务器就无法初始化
离线机重启后插件不生效？先看控制台报错
不要凭“插件列表里有名字”就认为装好了。打开开发者工具（Ctrl+Shift+I），切到 Console 标签页，重点关注前几条错误：
-
Error: Cannot find module 'fs-plus'→ 插件根目录缺package.json，或"main"指向的入口文件路径错误/大小写不匹配 -
Cannot read property 'onDidStopChanging' of undefined→ Atom 版本不匹配，构建环境比目标机高，API 已被移除 - 空白无报错但功能缺失 → 检查是否满足激活条件（如
autocomplete-python需先打开.py文件，且language-python必须已安装并加载）
真正麻烦的不是复制路径，而是每个插件对构建、激活、依赖的要求都不同——minimap 需要 apm link 或 npm run build，go-plus 还得额外部署 gopls 二进制。离线前，最好在联网机上跑通一次 apm test，看清它到底依赖什么。
