离线安装Atom插件可行但需满足三前提：官方deb/rpm/msi安装本体、构建机与目标机Atom版本完全一致、插件必须用apm install --production构建出含node_modules的完整副本；直接复制GitHub源码必失败，因Atom不自动执行依赖安装或编译。
离线安装 Atom 插件在内网环境下可行，但必须满足三个硬性前提：Atom 本体是官方 deb/rpm/msi 包安装、目标机与构建机 Atom 版本完全一致、插件必须用 apm install --production 构建出含 node_modules 的完整副本——缺一不可。
为什么直接复制 GitHub 源码到 ~/.atom/packages/ 一定失败
常见错误现象包括：重启 Atom 后插件不显示、控制台报 Error: Cannot find module 'season' 或 Failed to activate package 'linter-gcc' because it depends on 'atom-linter@^2.0.0'。根本原因不是路径放错，而是 Atom 启动时只加载已构建完成的插件目录，它不会自动执行 npm install 或 apm install。
- GitHub 上下载的 zip 或
git clone得到的是源码，不含node_modules，而几乎所有插件（如linter-gcc、autocomplete-python）都依赖其中的模块 - 部分插件含原生模块（如
spell-check），需apm调用内置node-gyp编译，npm install无法复现该过程 -
package.json中的engines.atom字段会被apm校验，版本不匹配时直接拒绝激活，报Cannot read property 'onDidStopChanging' of undefined
必须用 apm install --production 构建，不能用 npm install
apm 和 npm 不是等价替代关系。Atom 插件的构建流程由 apm 独立定义，包括依赖解析策略、devDependencies 处理逻辑、预编译脚本触发时机等。在内网构建机上运行以下命令才是唯一可靠路径：
apm install --production linter-gcc
-
--production参数关键：跳过devDependencies，减小体积且避免因测试工具缺失导致构建中断 - 构建完成后，进入
~/.atom/packages/linter-gcc，确认存在node_modules目录，且其中包含gcc、atom-linter等子目录 - 不要用
npm install替代——即使成功，apm的postinstall脚本（如生成语法绑定、注册服务）也不会执行，功能必然残缺
哪些插件在内网环境下注定无法使用
三类插件即使把整个 node_modules 拷过去，启动时也会卡住或报 Failed to fetch https://...：
- 依赖实时 API 的插件：
autocomplete-atom-api（需连接 GitHub 获取最新 API 文档）、platformio-ide（启动强制校验云端 toolchain） - 含动态下载逻辑的插件：
language-rust某些版本会在首次启用时拉取rustc语法定义文件 - 需要全局
apm运行时支持的插件：sync-settings本质包装了apm login和apm publish，离线机从未连过服务器就无法初始化
这类插件没有“离线模式”开关，其代码里硬编码了网络请求，改配置或删缓存都无效。
内网部署后插件不生效？先看开发者工具 Console 报错
不要凭感觉判断“装好了”。打开 Atom 开发者工具（Ctrl+Shift+I），切换到 Console 标签页，重点关注以下线索：
-
Error: Cannot find module 'fs-plus'→ 插件根目录缺package.json，或"main"字段指向不存在的入口文件（注意大小写，lib/main.js≠lib/Main.js） -
Failed to activate package 'autocomplete-python' because it depends on 'language-python@^1.0.0'→ 未同步安装前置依赖，language-python必须同样用apm install --production构建并放入packages目录 - 白屏或无响应 → 可能是插件含未编译的 CoffeeScript 源码，或
activationHooks配置错误（如写成"python"而非"language-python:grammar-used"）
最麻烦的不是拷贝文件，而是每个插件对激活时机、依赖粒度、构建产物形态的要求都不一样——autocomplete-python 靠语法包触发，go-plus 还得调外部 gopls 二进制，minimap 需要先 npm run build 出 dist/ 目录。内网部署前，务必在有网机器上跑通一次 apm test，看清它到底依赖什么。
