apm install --production是唯一可靠的离线插件构建命令；必须在与目标机完全一致Atom版本下执行，生成含node_modules的可运行副本，不可仅复制源码或用npm install替代。
apm install --production 是唯一能用的构建命令
离线插件不是复制粘贴就能跑，必须带 node_modules 和兼容性校验。只下载 GitHub 源码、解压后扔进 ~/.atom/packages，99% 会报 Error: Cannot find module 'season' 或直接不显示在 Settings → Install 列表里。
正确做法是在与目标机**完全一致 Atom 版本**（比如都是 v1.69.0）的联网机器上，执行：
apm install --production linter-gcc
执行完立刻检查插件目录下是否存在 node_modules，且里面包含 gcc、atom-linter 等子目录——这才是可迁移的完整副本。
-
--production必须加：跳过devDependencies，避免体积膨胀和构建失败 - 不能用
npm install替代：它不执行apm的 postinstall 脚本（比如编译 native 模块），linter-gcc就会调不起gcc - 不能只
git clone后npm install：源码仓库默认不含构建产物，部分插件（如minimap）还要求先运行npm run build
Atom 本体安装方式错了，离线插件全白搭
离线插件失效的第一大原因是 Atom 本体本身就不合规。用 AtomSetup-x64.zip 解压、或从非官方镜像下载“绿色版”，会导致 resources/app/apm 缺失或签名验证失败，后续所有 apm 命令都不可用。
必须用官方安装包，并确保系统依赖被正确注入：
- Windows：只认
AtomSetup-x64.exe（不是 .zip），安装时务必勾选Add to PATH - Debian/Ubuntu：用
atom-amd64.deb，执行dpkg -i，自动补全libasound2、libxkbfile1等底层库 - CentOS/RHEL：用
atom.x86_64.rpm，yum localinstall自动解决 glibc 版本兼容问题 - macOS：必须用官网
Atom-mac.zip（Apple 签名），不是 GitHub Release 里的未签名包
装完后终端运行 apm --version 能输出版本号，才算过关。
哪些插件根本不能离线用
不是所有插件都能拷过去就生效。三类插件在离线环境必然失败，提前识别能省大量排查时间：
- 依赖实时 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://... 或报 Cannot read property 'onDidStopChanging' of undefined。
插件放对了但没反应？先开控制台看报错
别凭“Settings 里出现名字”就认为装好了。打开开发者工具（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@^3.0.0'→ 没同步安装前置依赖，language-python也得走一遍apm install --production - 无报错但无补全 → 打开一个
.py文件，或手动触发语言模式（Ctrl+Shift+L→ 输入python），因为autocomplete-python靠activationHooks触发，不是装完就加载
真正麻烦的不是复制路径，而是每个插件对激活时机、依赖粒度、构建要求都不一样——linter 靠事件监听，go-plus 得调外部 gopls 二进制，离线前最好先在有网机器上跑通 apm test 看它到底依赖什么。
