离线安装Atom插件前必须使用官方合规安装包，Windows用AtomSetup-x64.exe、Debian/Ubuntu用atom-amd64.deb、CentOS/RHEL用atom.x86_64.rpm；非官方zip或绿色版缺失apm和签名机制，导致后续所有插件失效。
离线安装前必须确认 Atom 本体是否合规
不合规的 Atom 安装包会导致所有离线插件后续失效——哪怕你把 node_modules 打包得再完整也没用。Windows 用户只认 AtomSetup-x64.exe，Debian/Ubuntu 必须用 atom-amd64.deb，CentOS/RHEL 必须用 atom.x86_64.rpm。解压 AtomSetup-x64.zip 或使用第三方“绿色版”会直接丢失 resources/app/apm 和签名验证机制，apm install --production 命令根本跑不起来。
验证方式很简单：打开终端，执行 apm --version；能输出版本号（如 apm 2.6.2）才算过关。若提示 command not found，说明 PATH 没配对，或本体压根没装对。
必须用 apm install --production 构建插件，不能只复制源码
GitHub 上下载的插件仓库（比如 https://github.com/AtomLinter/linter-gcc）是源码，不是可运行副本。直接解压进 ~/.atom/packages/ 后重启，大概率报错 Cannot find module 'season' 或 Failed to activate package 'linter-gcc'。
正确做法是在与目标离线机**完全一致 Atom 版本**的联网机器上执行：
apm install --production linter-gcc
执行完后进入 ~/.atom/packages/linter-gcc 目录，确认存在 node_modules 文件夹，且其中包含 gcc、atom-linter 等子目录。这才是可迁移的完整副本。
-
--production参数不能省：跳过devDependencies，避免构建失败和体积膨胀 - 别用
npm install替代：它不执行 Atom 特有的 postinstall 脚本（比如编译 native 模块），linter-gcc就会调不起gcc二进制 - 版本错配很致命：在 v1.72.0 下构建的插件，放到 v1.69.0 的离线机上，可能触发
Cannot read property 'onDidStopChanging' of undefined
哪些辅助工具类插件根本不能离线用
不是所有“常用辅助工具”都能真正离线。三类插件在断网后必然瘫痪：
- 依赖实时 API 的：
autocomplete-atom-api（启动时拉 GitHub 上的 Atom 文档）、platformio-ide（强制校验云端 toolchain） - 含动态下载逻辑的：
language-rust某些版本首次启用会 fetch rustc 语法定义；atom-ide-ui可能尝试下载atom-languageclient运行时 - 需要全局
apm运行时支持的：sync-settings本质是包装了apm login和apm publish，离线机从未连过服务器就无法初始化
这类插件即使把整个 node_modules 拷过去，控制台也会卡在 Failed to fetch https://... 或直接静默失败。
离线机装好后不生效？先看开发者工具 Console 报错
别凭“插件出现在 Settings → Install 页面”就认为成功了。打开 Ctrl+Shift+I，切到 Console 标签页，盯住第一行错误：
-
Error: Cannot find module 'fs-plus'→ 插件根目录缺package.json，或"main"字段指向的入口文件（如./lib/main.js）不存在或路径大小写不匹配 -
Failed to activate package 'autocomplete-python' because it depends on 'language-python@^2.0.0'→ 缺少前置语言包，language-python也得按同样流程离线构建并放入packages - 空白无报错但功能不触发 → 检查是否打开了对应后缀文件（如
.py），或手动执行Ctrl+Shift+L设置语言模式，因为这类插件靠activationHooks触发，不是一启动就加载
最麻烦的从来不是打包迁移，而是每个辅助工具插件激活时机、依赖粒度、构建要求都不一样：autocomplete-python 绑语法包，linter 监听编辑事件，git-plus 调本地 git 命令——离线部署前，务必在联网环境跑通一次 apm test，看清它到底要什么。
