Atom离线插件装不上，首要原因是本体未用官方deb/rpm/msi包安装；必须用apm install --production在同版本Atom中构建含node_modules的完整副本，依赖实时API、动态下载或全局apm的插件无法离线使用。
Atom离线插件装不上？先看本体是不是“真官方安装”
离线插件根本跑不起来，八成不是插件的问题，而是 Atom 本体压根没装对。Windows 必须用 AtomSetup-x64.exe，Debian/Ubuntu 必须用 atom-amd64.deb，CentOS/RHEL 必须用 atom.x86_64.rpm。解压 AtomSetup-x64.zip、从非官网镜像下“绿色版”、或用 GitHub 上的 .tar.gz 源码包启动 —— 这些都会导致 apm 二进制缺失、签名验证失败、底层依赖（如 libasound2）未安装，后续所有离线操作都无效。
必须用 apm install --production 构建，不能只复制源码
GitHub 上下载的插件仓库（比如 https://github.com/AtomLinter/linter-gcc）只是源码，不含 node_modules，也不经过 Atom 特定构建流程。直接拷进 ~/.atom/packages/ 后重启，控制台大概率报 Cannot find module 'season' 或 Failed to activate package 'linter-gcc'。
- 在与目标离线机**完全一致版本**的 Atom（例如 v1.69.0）中执行：
apm install --production linter-gcc - 执行完后进入
~/.atom/packages/linter-gcc，确认存在node_modules目录，且里面包含gcc、atom-linter等子目录 - 整个插件文件夹（含
node_modules）打包迁移，不要删node_modules减体积 —— 它不是冗余，是运行必需 - 禁用
npm install替代：它不触发apm的 postinstall 脚本（如原生模块编译），linter-gcc会无法调用gcc可执行文件
哪些插件离线后注定失效？别白费劲
三类插件即使把 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，离线机从未连过服务器就初始化不了
插件装完不生效？打开控制台看真实报错
别凭“Settings → Packages 里显示 Installed”就认为成功。按 Ctrl+Shift+I 打开开发者工具，切到 Console 标签页，关键线索包括：
-
Error: Cannot find module 'fs-plus'→ 插件根目录缺package.json，或"main"字段指向的入口文件（如./lib/main.js）不存在、路径大小写不匹配 -
Failed to activate package 'autocomplete-python' because it depends on 'language-python@^2.0.0'→ 少装了前置依赖，language-python必须一并离线构建并放入packages/ -
Cannot read property 'onDidStopChanging' of undefined→ 构建插件时用的 Atom 版本（如 v1.72.0）和离线机实际版本（v1.69.0）不一致，API 已移除
真正麻烦的不是复制文件，而是每个插件的激活时机、依赖声明、构建产物形态都不同 —— autocomplete-python 靠 language-python:grammar-used 触发，minimap 需要 dist/ 目录，go-plus 还得配好外部 gopls 二进制。离线前，务必在联网机上先跑通 apm test 或手动打开对应类型文件验证是否加载。
