离线安装插件前必须用官方deb/rpm/msi包安装Atom本体，禁用.zip或第三方“绿色版”，否则缺失apm导致后续操作失败；插件须在与目标环境版本一致的Atom上用apm install --production构建含node_modules的完整副本，再拷贝至~/.atom/packages。
离线安装插件前必须确认 Atom 本体是官方 deb/rpm/msi 包安装的
直接解压 atom-amd64.zip 或从第三方“绿色版”安装的 Atom，大概率缺失 resources/app/apm，后续所有离线插件操作都会失败——apm 不在 PATH 里，apm install --production 根本跑不起来。
验证方式：终端执行 apm --version。能输出版本号（如 2.6.2），说明本体合格；若提示 command not found，先重装官方包，别往下走。
- Debian/Ubuntu：只认
atom-amd64.deb，用dpkg -i安装，系统会自动补libasound2等依赖 - CentOS/RHEL：用
atom.x86_64.rpm+yum localinstall，它能处理 glibc 版本兼容性 - Windows：只认
AtomSetup-x64.exe，双击运行；AtomSetup-x64.zip是无效包，解压后打不开
插件必须用 apm install --production 构建完整副本，不能只拷源码
把 GitHub 上 clone 下来的插件文件夹直接扔进 ~/.atom/packages/，90% 情况下启动报错：Error: Cannot find module 'season' 或 Failed to activate package 'xxx' because it depends on 'linter@^3.0.0'——因为源码里没 node_modules，也没处理 peerDependency。
真正有效的做法，是在**与目标机完全一致的 Atom 版本**（比如目标是 v1.69.0，联网机也得装 v1.69.0）上执行：
apm install --production linter-gcc
这一步会拉取源码、安装全部 dependencies 和 devDependencies（关键！），并生成可运行的 node_modules 目录。检查插件目录下是否存在 node_modules，且里面含 gcc、atom-linter 等子目录，才算构建成功。
package.json 和 main 字段缺一不可
即使有 node_modules，插件仍不生效？打开开发者工具（Ctrl+Shift+I），看控制台是否报 Cannot find module 'fs-plus' 或直接跳过加载——很可能是 package.json 不存在，或 "main" 字段指向错误路径（比如写成 "./src/main.js"，但实际编译后入口是 "./lib/main.js"）。
检查要点：
- 插件根目录必须有有效的
package.json -
"main"值需指向已存在的 JS 文件，且该文件导出activate/deactivate方法 - 若插件用了新版 Atom API（如
TextEditor::onDidStopChanging），而你的 Atom 是 v1.58，但插件要求 v1.70+，也会静默失败——查插件 README 的engines.atom字段
离线部署后功能缺失，大概率是激活钩子没触发
插件显示“已启用”，但 autocomplete-python 没补全、linter-gcc 不报错——不是安装失败，而是没满足激活条件。Atom 插件大多靠语言包或文件类型触发，比如 autocomplete-python 只在 .py 文件且 grammar 设为 source.python 时才加载。
排查方法：
- 打开一个目标文件（如
test.py），按Ctrl+Shift+P输入Grammar，确认当前 grammar 是Python - 进
Settings → Packages → autocomplete-python → Settings，看File Types是否含source.python - 某些插件（如
platformio-ide）依赖外部 CLI 工具，离线环境没装platformio，功能必然缺失——这类插件本质无法真正离线
真正的离线可用性，取决于插件是否纯前端、无网络调用、无外部二进制依赖。这点最容易被忽略，等装完才发现白忙一场。
