离线安装Atom插件失败主因是未执行apm install --production构建，导致缺失node_modules及兼容性校验；必须用官方deb/rpm/msi包安装Atom本体，并在与目标机完全一致的Atom版本下构建。
离线安装 Atom 插件失败，90% 是因为没运行 apm install --production，而不是路径放错或插件选错。
必须用官方安装包启动 Atom 才能离线装插件
Atom 本体若来自 AtomSetup-x64.zip、.tar.gz 或非官方镜像的“绿色版”，离线插件必然失败——它缺 resources/app/apm 二进制和签名验证链。控制台会报 Error: Cannot find module 'fs-plus' 或直接不加载任何插件。
- Windows：只认
AtomSetup-x64.exe（msi 包也行），禁用 zip - Debian/Ubuntu：必须用
atom-amd64.deb，执行dpkg -i，系统自动补libasound2等底层依赖 - CentOS/RHEL：用
atom.x86_64.rpm，yum localinstall解决 glibc 兼容性 - macOS：仅支持 Apple 签名的
Atom-mac.zip（不是 GitHub Release 里的无签名包）
离线构建插件唯一可靠命令是 apm install --production
在与目标离线机 完全一致 Atom 版本 的联网机器上执行该命令，不是为了下载，而是生成可运行副本。GitHub 源码包本身不含 node_modules，Atom 启动时不会自动补。
- 错误做法：直接
git clone后复制整个文件夹 → 缺node_modules，启动报Cannot find module 'season' - 错误做法：用
npm install替代 → 漏掉 Atom 特有构建步骤（如 native 模块编译），linter-gcc调不了gcc - 正确流程：
apm install --production linter-gcc→ 进入~/.atom/packages/linter-gcc确认存在node_modules/gcc和node_modules/atom-linter→ 整个文件夹打包迁移 - 版本不匹配会出诡异错误，例如 v1.72.0 构建的插件在 v1.69.0 上激活时报
Cannot read property 'onDidStopChanging' of undefined
哪些插件根本不能离线用
三类插件即使拷全 node_modules 也会卡死或报 Failed to fetch https://：
- 依赖实时 API：如
autocomplete-atom-api（需连 GitHub 拉最新文档）、platformio-ide（启动强制校验云端 toolchain） - 含动态下载逻辑：如某些
language-rust版本首次启用时拉取rustc语法定义 - 需要全局
apm运行时：如sync-settings，本质包装了apm login和apm publish，离线机从未连过服务器就无法初始化
装完不生效？先开控制台看真实报错
别凭“Settings → Install 里有名字”判断成功。按 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本身没装） - 空白无报错但功能不触发 → 检查激活条件：是否打开
.py文件触发autocomplete-python？是否手动设置语言模式（Ctrl+Shift+L输入python）？
真正麻烦的不是复制文件，而是每个插件对构建、激活时机、外部二进制（如 gopls、gcc）的要求完全不同——离线前，最好先在有网环境跑通 apm test 或 npm run build 确认产物结构。
