离线安装atom插件必须先确保本体用官方deb/rpm/msi包安装（禁用.zip），再在同版本atom中用apm install --production构建含node_modules的完整副本，依赖实时api、动态下载或全局apm的插件无法离线使用。
离线安装前必须确认 Atom 本体安装方式是否正确
直接解压 AtomSetup-x64.zip 或从非官方镜像下载“绿色版”会导致后续所有插件离线安装失败——因为缺失 resources/app/apm 和签名验证机制。Windows 用户只认 AtomSetup-x64.exe，Debian/Ubuntu 必须用 atom-amd64.deb，CentOS/RHEL 必须用 atom.x86_64.rpm。dpkg/yum 安装后会自动补全 libasound2、libxkbfile1 等底层依赖，而 zip 包完全不提供这些。
apm install --production 是唯一可靠的离线插件构建命令
在联网机器上执行该命令，不是为了“下载插件”，而是为了生成含完整 node_modules 的可运行副本。常见错误包括：
- 仅复制 GitHub 源码仓库（如
git clone后直接拷贝），缺少node_modules→ 启动时报Cannot find module 'season' - 用
npm install替代apm install→ 缺少 Atom 特定的构建步骤（如编译 native 模块），导致linter-gcc等插件无法调用gcc - 未匹配目标环境 Atom 版本 → 例如在 v1.69.0 环境下用 v1.72.0 构建插件，激活时出现
Cannot read property 'onDidStopChanging' of undefined
正确流程：在与离线机**完全一致版本**的 Atom 下，运行 apm install --production linter-gcc，进入 ~/.atom/packages/linter-gcc 确认存在 node_modules 目录及其中的 gcc、atom-linter 子目录，再整体打包迁移。
哪些插件根本不能离线用
不是所有插件都支持离线部署，三类插件在离线环境下必然失效：
- 依赖实时 API 的插件：
autocomplete-atom-api（需连接 GitHub 获取最新 Atom API 文档）、platformio-ide（启动时强制校验云端 toolchain） - 含动态下载逻辑的插件：如
language-rust的某些版本会在首次启用时拉取rustc语法定义文件 - 需要全局
apm运行时支持的插件：例如sync-settings本质是包装了apm login和apm publish，离线机没连过服务器就无法初始化
这类插件即使把整个 node_modules 拷过去，启动时也会卡在加载阶段或报 Failed to fetch https://...。
离线机重启后插件不生效？先看控制台报错
不要凭感觉判断“装好了”，打开开发者工具（Ctrl+Shift+I），切换到 Console 标签页，常见线索有：
-
Error: Cannot find module 'fs-plus'→ 插件根目录缺package.json，或"main"字段指向不存在的入口文件 -
Failed to activate package 'linter' because it depends on 'linter@^3.0.0'→linter本身没离线装好，或版本号不满足 peerDependency 要求 - 空白输出但插件列表里没出现 → 检查
~/.atom/packages/下插件文件夹名是否和package.json中"name"字段完全一致（大小写敏感）
真正能离线跑起来的插件，其 node_modules 必须是构建产物，不是源码；其依赖链必须全部静态化；其 API 调用必须兼容你装的那个 Atom 小版本号——这三个条件缺一不可。
