离线安装atom插件必须用apm install --production在与目标机完全一致的atom版本下构建含node_modules的可运行副本，否则因缺失依赖、api不兼容或未执行atom特有构建步骤而失败。
离线安装 Atom 插件不是“复制粘贴就能用”，而是必须在与目标机完全一致的 Atom 版本下，用 apm install --production 构建出含 node_modules 的可运行副本——否则 90% 的插件会报 Cannot find module 或根本无法激活。
为什么直接复制 GitHub 源码到 ~/.atom/packages 必然失败
常见错误是把 git clone 下来的仓库原样扔进插件目录，但 Atom 不认源码，只加载已构建产物。典型表现包括：
-
Failed to activate package 'autocomplete-python' because it depends on 'language-python'—— 缺少前置依赖，且未在离线机上一并安装 -
Error: Cannot find module 'season'——node_modules根本不存在，package.json里的dependencies全都没装 - 插件列表里显示已安装，但打开
.py文件毫无补全 ——activationHooks配置错误或入口文件路径大小写不匹配（如lib/main.js写成Lib/Main.js）
apm install --production 是唯一可靠构建命令
这个命令不是为了“联网下载”，而是在本地完成 Atom 特定的构建流程：安装依赖、编译 native 模块（如 linter-gcc 调用的 gcc 绑定）、生成 node_modules 结构。关键约束有：
- 必须在与离线机完全相同版本的 Atom 下执行（比如离线机是
v1.60.0，构建机也得是v1.60.0，差一个小版本都可能触发Cannot read property 'onDidStopChanging' of undefined） - Windows 用户只能用
AtomSetup-x64.exe安装本体；Debian/Ubuntu 必须用atom-amd64.deb；CentOS/RHEL 必须用atom.x86_64.rpm—— zip 包缺失resources/app/apm和签名验证机制，apm命令本身都不可用 - 执行后务必进入插件目录确认：
node_modules存在，且其中包含该插件实际依赖的子模块（如linter-gcc下要有gcc和atom-linter目录）
哪些插件离线部署注定失败
三类插件即使拷全了 node_modules 也无法工作，因为它们的设计就依赖在线环境：
- 依赖实时 API：如
autocomplete-atom-api（需连接 GitHub 获取最新 API 文档）、platformio-ide（启动时强制校验云端 toolchain） - 含动态下载逻辑：如某些版本的
language-rust，首次启用会尝试拉取rustc语法定义文件，报错Failed to fetch https://... - 需要全局
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 depe...（截断）→ 往往是依赖插件（如linter-ui-default）没一起装，或版本不兼容 - 空白报错但功能缺失 → 检查右下角状态栏语言模式是否正确（快捷键
Ctrl+Shift+L输入python回车），autocomplete-python等插件只在对应 grammar 加载后才触发
真正麻烦的不是复制文件，而是每个插件对激活时机、依赖粒度、构建要求都不一样。离线前最好在有网机器上跑通 npm install && apm test，看清它到底依赖什么、何时加载、是否调外部二进制——这些细节，文档里往往不会写。
