离线安装失败主因是atom本体安装错误：必须用官方exe/deb/rpm/apple签名zip包，禁用zip/tar.gz等绿色版；需在同版本atom中执行apm install --production构建含node_modules的完整插件副本，且三类插件（依赖实时api、动态下载、需全局apm）无法离线使用。
离线安装失败，八成是 Atom 本体装错了
Atom 插件离线安装不是“复制粘贴就能用”，前提是 Atom 本体本身能正常调用 apm。如果你用的是 AtomSetup-x64.zip（Windows）、atom-amd64.tar.gz（Linux）或非 Apple 签名的 macOS 包，apm 二进制文件大概率缺失或损坏，后续所有插件构建都会卡在 command not found 或启动时报 Cannot find module 'season'。
必须用官方分发渠道的安装包：
- Windows：只认
AtomSetup-x64.exe（.msi 封装），安装时勾选 Add to PATH - Debian/Ubuntu：必须用
atom-amd64.deb，执行dpkg -i atom-amd64.deb，自动补全libasound2、libxkbfile1等底层依赖 - CentOS/RHEL：用
atom.x86_64.rpm，配合yum localinstall解决 glibc 版本兼容问题 - macOS：必须用 GitHub Releases 页面的
Atom-mac.zip（含 Apple 签名），不是其他镜像站的“精简版”
apm install --production 是唯一有效的离线构建命令
离线环境不能靠“下载源码 → 解压 → 放进 ~/.atom/packages”来运行插件。GitHub 上的插件仓库（如 linter-gcc）默认只有源码，没有 node_modules，也没有编译后的原生模块（如 gcc 子目录）。
正确做法是在一台与目标机 完全一致 Atom 版本（例如都是 v1.69.0）、且本体安装正确的机器上执行：
apm install --production linter-gcc
执行后检查插件目录是否存在 node_modules，且里面包含实际可调用的子模块（如 gcc、atom-linter）。然后整体打包迁移，不要只拷 lib/ 或 src/。
常见错误包括：
- 用
npm install替代apm install：漏掉 Atom 特定的 postinstall 脚本，导致linter-gcc找不到gcc可执行文件 - 在 v1.72.0 下构建，却迁移到 v1.69.0 环境：激活时报
Cannot read property 'onDidStopChanging' of undefined - 只复制 GitHub 源码 ZIP，没运行任何构建命令：启动即报
Cannot find module 'fs-plus'
有些插件根本没法离线用
不是所有插件都能通过拷 node_modules 解决。三类插件在离线环境下必然失效：
- 依赖实时 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://... 或直接不加载。
插件放对路径但不生效？重点查 activationHooks 和依赖链
插件出现在 Settings → Install 列表里 ≠ 它已激活。Atom 是按需加载，很多插件靠 activationHooks 触发，比如 autocomplete-python 必须同时满足：
-
language-python已安装并启用 - 当前打开的是
.py文件，或手动设置了语言模式（Ctrl+Shift+L→ 输入python） -
package.json中"activationHooks"值为"language-python:grammar-used"，不是"python"或大小写错误 -
"main"字段指向的入口文件（如./lib/main.js）真实存在，路径大小写与文件系统一致（Windows 下尤其敏感）
如果 autocomplete-python 装了但无补全，先打开 DevTools（Ctrl+Shift+I），看 Console 是否有 Failed to activate package 报错，再顺藤摸瓜查 package.json 和依赖是否完整。
