离线安装Atom插件失败主因是插件目录缺失node_modules；必须在与目标机完全一致的Atom版本下，用apm install --production构建含依赖的可运行副本，且本体须为官方deb/rpm/msi安装包。
离线安装 Atom 插件失败，八成不是路径放错了，而是插件目录里压根没 node_modules —— Atom 不会自动装依赖，它只认“构建完的包”，不是源码。
为什么直接复制 GitHub 源码包进 ~/.atom/packages/ 会失效
常见错误现象包括：重启 Atom 后插件不显示、控制台报 Error: Cannot find module 'season' 或 Failed to activate package 'linter-gcc'。根本原因有三个：
-
package.json里的dependencies没被安装，require('fs-plus')这类模块自然找不到 - 插件可能含原生模块（如
linter-gcc调用gcc），需apm install触发node-gyp编译，npm install无法替代 -
activationHooks（如"language-python:grammar-used"）未满足，插件根本不会初始化，autocomplete-python 就是典型
必须用 apm install --production 构建，且环境要完全一致
在联网机器上执行这步，不是为了下载，是为了生成可运行副本。关键约束很硬：
- 目标离线机 Atom 版本必须和构建机**完全一致**（比如都是
v1.69.0），版本差一点就可能报Cannot read property 'onDidStopChanging' of undefined - Atom 本体必须用官方安装包：Windows 用
AtomSetup-x64.exe，Debian 用atom-amd64.deb，macOS 用Atom-mac.zip（Apple 签名版）；.zip解压版缺失resources/app/apm，后续全崩 - 命令必须带
--production参数：apm install --production linter-gcc，跳过devDependencies，减小体积且避免构建失败 - 执行后进
~/.atom/packages/linter-gcc目录确认存在node_modules，且里面有gcc、atom-linter等子目录
哪些插件离线根本跑不起来
别白费力气打包迁移，三类插件离线必挂：
- 依赖实时 API 的：如
autocomplete-atom-api（启动时连 GitHub 拉 API 文档）、platformio-ide（强制校验云端 toolchain） - 含动态下载逻辑的：如某些
language-rust版本，首次启用会fetchrustc 语法定义文件 - 需要全局
apm运行时的：如sync-settings，本质是包装apm login和apm publish，离线机没连过服务器就卡死
离线机装完不生效？先看控制台报错，再查三处
打开开发者工具（Ctrl+Shift+I），切到 Console 标签页，线索往往很直白：
-
Error: Cannot find module 'fs-plus'→package.json缺失，或"main"字段指向的入口文件（如./lib/main.js）不存在 / 大小写不匹配 - 文件夹名和
package.json里"name"值不一致（如文件夹叫autocomplete-python，但package.json写的是"name": "atom-autocomplete-python"） - 插件依赖其他语言包（如
autocomplete-python依赖language-python），但后者没一并离线装上
真正麻烦的不是复制文件，而是每个插件激活时机、依赖粒度、构建要求都不同——minimap 需要 dist/ 构建产物，go-plus 得调外部 gopls 二进制，linter 靠事件监听触发。离线前，最好先在有网机器上跑通 apm install --production && apm test，看清它到底要什么。
