atom离线插件安装失败主因是本体未用官方安装包（如windows须用atomsetup-x64.exe而非.zip）或未在同版本atom下执行apm install --production构建，导致缺失node_modules及atom特有postinstall步骤。
Atom 离线插件安装失败，90% 是因为本体没装对或构建命令用错了——不是路径放错、不是解压不全，而是 apm 根本没跑起来，或者跑在了错误的上下文里。
确认 Atom 本体安装方式是否合法
离线插件依赖 apm 二进制和签名验证机制，这两样只存在于官方安装包中：
- Windows 必须用
AtomSetup-x64.exe（不是.zip）；双击无响应？说明你下的是无效包 - Debian/Ubuntu 必须用
atom-amd64.deb，执行dpkg -i；tar.gz或第三方“绿色版”会缺失libasound2、libxkbfile1等底层依赖 - macOS 必须用官网发布的
Atom-mac.zip（Apple 签名完整包），不是 GitHub Release 里的源码压缩包 - 装完后检查：
C:Users\AppDataLocaltominpm.exe（Win）或/usr/bin/apm（Linux/macOS）是否存在；不存在就重装
必须用 apm install --production 构建插件
GitHub 上下载的插件源码 ≠ 可运行插件。Atom 启动时不执行 npm install，只加载已构建完成的目录。常见错误包括：
- 直接
git clone后拷进~/.atom/packages/→ 缺node_modules，报Cannot find module 'season' - 在目标机上执行
npm install→ 漏掉 Atom 特定 postinstall 步骤（如编译 native 模块），linter-gcc调不起gcc - 用高版本 Atom（如 v1.72.0）构建，装到 v1.69.0 离线机 → 报
Cannot read property 'onDidStopChanging' of undefined
正确做法：在与离线机完全一致版本的 Atom 下，运行：
apm install --production linter-gcc
然后进 ~/.atom/packages/linter-gcc 确认存在 node_modules 目录，且内含 gcc 和 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"字段指向不存在的入口文件 -
Failed to activate package 'linter' because it depends on 'linter@^3.0.0'→ 依赖插件（如linter）本身没装，或没走apm install --production构建 - 空白控制台但插件不显示 → 检查
package.json中"activationHooks"是否写对（例如autocomplete-python要求"language-python:grammar-used"，不是"python"）
最麻烦的从来不是复制文件，而是每个插件对激活时机、依赖粒度、构建产物路径的要求都不一样——minimap 需要 dist/，go-plus 要调外部 gopls 二进制，autocomplete-python 必须等 language-python 先加载并打开 .py 文件才触发。
