Atom本体必须用官方安装包（Windows用.exe、Linux用.deb/.rpm、macOS用官网签名.zip），否则缺失apm导致离线安装必然失败；插件须在同版本Atom中用apm install --production构建完整副本，含node_modules和有效main入口；依赖实时API、动态下载或全局apm的插件无法离线使用。
先确认 Atom 本体是否支持离线安装
离线安装失败，80% 的根源不在插件，而在 Atom 本体本身。非官方安装包（比如 AtomSetup-x64.zip、atom-amd64.tar.gz、第三方“绿色版”）几乎必然缺失 resources/app/apm，导致 apm 命令根本不可用。
验证方式很简单：打开终端，执行 apm --version。若报 command not found 或无任何输出，说明本体已损坏，必须重装：
- Windows：只认
AtomSetup-x64.exe（msi 也可），双击运行；.zip是无效包 - Debian/Ubuntu：必须用
atom-amd64.deb，执行dpkg -i；.tar.gz不处理libasound2等底层依赖 - CentOS/RHEL：用
atom.x86_64.rpm+yum localinstall，自动适配 glibc 版本 - macOS：必须用官网
Atom-mac.zip（含 Apple 签名），不是 GitHub Release 里的源码包
检查插件是否真被构建为可运行副本
直接把 GitHub 源码（如 git clone 或 download zip）扔进 ~/.atom/packages/，90% 会静默失败——因为没 node_modules，也没执行 postinstall 步骤。
真正有效的离线插件，必须是在与目标机**完全一致 Atom 版本**（例如都是 v1.69.0）下，用以下命令生成的：
apm install --production linter-gcc
执行后务必进入插件目录（如 ~/.atom/packages/linter-gcc），确认两点：
-
node_modules目录存在，且里面包含gcc、atom-linter等实际子目录（不是空文件夹） -
package.json存在，且"main"字段指向一个真实存在的 JS 文件（如./lib/main.js），该文件需导出activate方法
别用 npm install 替代——它不调用 Atom 特有的 node-gyp 路径，原生模块（如 linter-gcc）编译后缺可执行文件。
看 DevTools 控制台第一行错误
插件显示“已启用”但没反应？别猜，直接开开发者工具：Ctrl+Shift+I → 切到 Console 标签页 → 刷新 Atom（或重启），盯住第一条红色报错：
-
Error: Cannot find module 'season'→ 插件根目录缺package.json，或"main"指向了不存在的路径 -
Failed to activate package 'autocomplete-python'→ 依赖未装全，常见于跳过apm install --production直接拷源码 -
Cannot read property 'onDidStopChanging' of undefined→ Atom 版本不匹配（如在 v1.72 构建后迁移到 v1.69） -
Module version mismatch→ 原生模块编译环境不一致，需运行apm rebuild（关掉所有 Atom 进程后再执行）
哪些插件根本没法离线用
不是所有插件都能靠“拷文件+装依赖”搞定。三类插件在离线环境下必然失败，提前识别能省几小时白忙活：
- 依赖实时 API 的插件：
autocomplete-atom-api（需连 GitHub 拉最新文档）、platformio-ide（启动强制校验云端 toolchain） - 含动态下载逻辑的插件：
language-rust某些版本首次启用时拉取rustc语法定义；atom-ide-ui尝试下载 LSP server - 需要全局
apm运行时支持的插件：sync-settings本质是包装apm login和apm publish，离线机没连过服务器就无法初始化
这类插件即使把整个 node_modules 拷过去，启动时也会卡在加载阶段，或控制台明确报 Failed to fetch https:// —— 这不是配置问题，是设计上就不支持离线。
