不能直接复制插件文件夹，因为Atom插件需通过apm install --production构建生成node_modules、编译原生模块、校验Atom API版本兼容性；否则会报Cannot find module 'season'或API属性未定义等错误，导致功能残缺或静默失效。
apm install 本地包安装不是把 ZIP 解压扔进 packages 就完事——它必须走完整构建流程，否则插件大概率启动失败或功能残缺。
为什么不能直接复制插件文件夹？
Atom 插件不是纯 JS 脚本，很多依赖需编译（如 linter-gcc 的 native 模块）、依赖特定版本的 Atom 内部 API（如 atom-workspace）、或需生成 node_modules 中经 apm 重写的模块路径。直接拷贝源码目录会导致：
-
Cannot find module 'season'（缺失核心 Atom 运行时依赖） -
Cannot read property 'onDidStopChanging' of undefined（API 版本错配，常见于跨 Atom 小版本构建） - 插件菜单/命令不出现、Linter 不触发、自动补全失效等静默故障
正确使用 apm install 安装本地插件包
前提是：目标机器已装好同版本 Atom（deb/rpm/msi 官方包），且已配置好 apm 可执行路径（Windows 在 resources/app/apm/bin，Linux/macOS 通常在 PATH 中）。
- 下载插件的 发布版 tarball（非 GitHub 源码 ZIP），地址形如
https://github.com/username/package-name/releases/download/vX.Y.Z/package-name-X.Y.Z.tar.gz - 解压后得到一个不含
node_modules的干净目录，例如linter-eslint-8.5.5/ - 终端进入该目录，执行：
apm install --production - 不要用
npm install替代 —— 它不会链接 Atom 内置模块，也不会处理compile或rebuild步骤
离线环境下的可靠构建流程
真离线（无网络 + 无代理）必须在一台「同操作系统、同 Atom 版本、同架构」的联网机器上预构建：
- 先确认 Atom 版本：
atom --version（如1.72.0） - 下载对应插件 release 包，解压到空目录
- 在该目录中运行：
apm install --production - 构建完成后，整个目录（含生成的
node_modules）可直接打包复制到目标机的~/.atom/packages/下 - 目标机无需再运行任何命令，重启 Atom 即可识别
容易被忽略的权限与路径陷阱
Windows 用户常卡在路径权限和符号链接上：
-
apm install在 Windows 上若提示EACCES或EPERM，不是权限问题，而是当前 shell 未以管理员身份运行（尤其当 Atom 安装在Program Files） - macOS/Linux 下若插件启用
native modules（如pty.js），apm install必须由同一用户执行，且该用户需有python和make环境（apm会调用node-gyp） - 不要把插件目录名改成带版本号的（如
linter-eslint-8.5.5），Atom 要求目录名严格等于name字段值（查看其package.json）
最常出问题的环节不是下载，而是构建阶段是否真正复现了目标环境——Atom 版本差一个小数点、Node.js 大版本不一致、甚至 apm 自身缓存没清，都可能导致插件加载时崩溃而非报错。
