离线安装Atom插件前必须确认本体合规：Windows须用AtomSetup-x64.exe，Debian/Ubuntu用atom-amd64.deb，CentOS/RHEL用atom.x86_64.rpm；zip包因缺失resources/app/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 depe（截断）→ 依赖未满足，比如linter要求linter-ui-default@^3.0.0，但该包未安装或版本不匹配 - 无任何报错但功能缺失 → 检查
activationHooks是否触发，例如autocomplete-python需要先打开.py文件且language-python已加载
真正麻烦的不是下载或复制，而是每个插件对激活时机、依赖粒度、构建要求都不一样——autocomplete-python 依赖语法包触发，linter 靠事件监听，go-plus 还得调外部 gopls 二进制。
