离线安装atom插件失败主因是未执行apm install --production构建，导致缺少node_modules及兼容性校验；必须在与目标机完全一致的atom版本下构建，且本体须用官方deb/rpm/msi包安装。
离线安装 Atom 插件失败，基本不是路径放错了，而是没走完 apm install --production 构建流程——插件目录里缺 node_modules，Atom 启动时根本不会加载它。
为什么直接复制 GitHub 源码包进 ~/.atom/packages 会失效
GitHub 上下载的 zip 包（比如 linter-gcc-2.0.0.zip）只是源码，不含 node_modules，也不含 Atom 特定的构建产物。Atom 启动时只扫描已构建完成的插件目录，遇到缺失依赖就报错：
Error: Cannot find module 'season'Failed to activate package 'linter-gcc' because it depends on 'linter@^3.0.0'- 插件在 Settings → Install 页面不显示，或显示为“Not Installed”
这不是 Atom 找不到文件夹，是它拒绝加载一个“未完工”的插件。
必须用 apm install --production，不能用 npm install
npm install 和 apm install 行为差异很大：前者只装 package.json 里的 dependencies，后者还会执行 Atom 定制的 postinstall 脚本、校验 engines.atom 兼容性、编译 native 模块（如 linter-gcc 依赖的 gcc binding）。很多教程说“解压后进目录跑 npm install”，结果是：
- native 模块没编译 → 插件功能缺失（比如无法调用 gcc）
- devDependencies 没跳过 →
node_modules体积翻倍，还可能引入冲突 -
apm的版本锁机制没触发 → 在目标机上激活时报Cannot read property 'onDidStopChanging' of undefined
正确做法是在与离线机**完全一致 Atom 版本**（例如 v1.69.0）的联网机器上，运行：
apm install --production linter-gcc
然后确认 ~/.atom/packages/linter-gcc/node_modules 下有 gcc、atom-linter 等实际子目录，再整体打包迁移。
离线前必须确认 Atom 本体安装方式是否合规
如果离线机上的 Atom 是解压 AtomSetup-x64.zip 得来的“绿色版”，后续所有插件离线安装都会失败——因为缺少 resources/app/apm 和签名验证链，apm 命令本身都不可用。必须用官方分发包：
- Windows：只认
AtomSetup-x64.exe（安装时务必勾选 “Add to PATH”） - Debian/Ubuntu：只用
atom-amd64.deb（dpkg -i安装，自动补libasound2等底层依赖） - CentOS/RHEL：只用
atom.x86_64.rpm
zip 包不提供 apm 可执行文件，也不注册系统级依赖，强行复制插件进去只会让 Atom 启动时静默忽略整个目录。
最容易被忽略的一点：某些插件（如 autocomplete-atom-api、atom-beautify 的在线格式化后端）在运行时仍需联网获取数据或调用远程服务，这类插件即使成功构建了 node_modules，离线后核心功能也会失效——得看插件文档里有没有标 “requires internet” 或 “fetches from atom.io” 这类说明。
