离线安装Atom插件前必须确认本体合规：Windows用AtomSetup-x64.exe，Debian/Ubuntu用atom-amd64.deb，CentOS/RHEL用atom.x86_64.rpm，macOS用Apple签名的Atom-mac.zip；须在同版本Atom中执行apm install --production生成含node_modules的完整副本；依赖实时API、动态下载或全局apm的插件无法离线使用。
离线安装前必须确认 Atom 本体是否合规
直接解压 AtomSetup-x64.zip 或用非官方“绿色版”会导致后续所有插件离线安装失败——因为缺失 resources/app/apm 二进制文件，且签名验证机制被破坏。Windows 必须用 AtomSetup-x64.exe，Debian/Ubuntu 必须用 atom-amd64.deb，CentOS/RHEL 必须用 atom.x86_64.rpm，macOS 必须用 Apple 签名的 Atom-mac.zip（不是 GitHub 上的源码包）。dpkg/yum 安装还会自动补全 libasound2、libxkbfile1 等底层依赖，zip 包完全不提供这些。
apm install --production 是唯一有效的离线构建命令
在与目标离线机**完全一致版本**的 Atom（例如 v1.69.0）下执行该命令，目的不是下载，而是生成含完整 node_modules 的可运行副本。常见错误包括：
- 仅复制 GitHub 源码（如
git clone后直接拷贝），缺少node_modules→ 启动时报Error: Cannot find module 'season' - 用
npm install替代apm install→ 缺少 Atom 特定 postinstall 步骤（如编译 native 模块），导致linter-gcc等无法调用二进制工具 - 未匹配 Atom 版本 → 在 v1.72.0 下构建的插件，放到 v1.69.0 离线机上激活时会报
Cannot read property 'onDidStopChanging' of undefined
执行后务必进入 ~/.atom/packages/linter-gcc（以实际插件名为准）检查是否存在 node_modules 目录，且其中包含 gcc、atom-linter 等子目录。
哪些插件根本不能离线用
三类插件在无网环境下必然失效，拷再全也没用：
- 依赖实时 API 的：如
autocomplete-atom-api（需连接 GitHub 获取最新 API 文档）、platformio-ide（启动强制校验云端 toolchain） - 含动态下载逻辑的：如某些版本的
language-rust首次启用时拉取rustc语法定义文件 - 需要全局
apm运行时支持的：如sync-settings本质是包装了apm login和apm publish，离线机从未连过服务器就无法初始化
这类插件即使把整个 node_modules 拷过去，控制台也会明确报 Failed to fetch https://...。
手动拷贝插件文件夹时的关键细节
从 GitHub Releases 页面下载插件的 .zip 包（别下 “Source code”），解压后重命名文件夹为纯名字（如把 emmet-3.0.2 改成 emmet）。Windows 路径是 %USERPROFILE%\.atom\packages，macOS/Linux 是 ~/.atom/packages。必须满足：
- 插件文件夹里含
package.json，且"name"字段值与文件夹名**完全一致**（大小写敏感） - 不要多套一层父目录（如解压出
atom-beautify-master/，就直接复制这个文件夹进去，别再进它里面复制） - 避免云同步干扰：确保
.atom不在 OneDrive/iCloud 同步路径下 - 装完别急着重启，先按
Ctrl+Shift+P输入Window: Reload刷新一次，比全重启快
真正容易被忽略的是：插件是否满足激活条件——比如 linter-eslint 只有打开 .js 文件、右下角语法模式显示为 JavaScript 时才加载；而 markdown-preview-plus 要求先禁用内置 markdown-preview，否则快捷键 Ctrl+Shift+M 会失效。
