apm install 不支持直接指定版本号，如 linter@2.3.0 会报错；必须通过 clone 对应 tag 源码、检查 engines.atom 兼容性、执行 apm install --production 安装，且离线部署后需验证模块加载与 api 兼容性。
apm install 不支持直接指定插件版本号
执行 apm install linter@2.3.0 会报错 Command failed: npm install --save --production linter@2.3.0，因为 apm 的 install 命令只接受包名，不解析 @x.y.z 语义化版本后缀——它内部调用的是 npm install <pkg></pkg>，而非 npm install <pkg>@<version></version></pkg>。
想装旧版插件，必须绕过 apm install 的自动解析逻辑，改用底层 npm 或手动控制源码 + package.json。
在目标 Atom 版本上 clone + 修改 package.json 再 apm install
这是最可靠、兼容性最强的做法，尤其适用于离线或老旧 Atom（如 v1.69.0）环境。
- 去插件 GitHub 仓库的
Releases页面，找到对应旧版本的 tag（比如v2.3.0），用git clone -b v2.3.0 https://github.com/atom/linter.git拉取 - 进入该目录，检查
package.json中的"engines": {"atom": ">=1.40.0"}是否与你的 Atom 版本兼容；若不兼容（比如你用 v1.58.0，但插件要求 >=1.70.0），需手动降级依赖或跳过 - 确认
"main"字段指向存在的文件（如"./lib/main.js"），且该文件导出activate()方法 - 运行
apm install --production（不是npm install）——这会使用 Atom 自带的 Node 和 npm，生成正确的node_modules，并处理peerDependencies
直接下载 release tarball 后 npm install 失败的常见原因
很多人下载 linter-v2.3.0.tar.gz 解压后进目录执行 npm install，结果 Atom 启动时报 Cannot find module 'season' 或静默不加载。这是因为：
-
npm install使用的是系统全局 Node，而 Atom 内置 Node 版本（如 v12.22.12）可能与之不兼容 - 插件里含原生模块（如
pathwatcher）时，npm install编译产物无法被 Atom 加载，必须用apm rebuild -
package.json中的devDependencies可能包含构建脚本（如babel），但npm install --production会跳过它们，导致lib/目录为空
正确做法是：解压后进目录，删掉 node_modules（如果已有），再执行 apm install --production。
离线部署时如何验证旧版本插件是否真正可用
装完别急着重启，先做三件事：
- 打开 Atom 开发者工具（
Ctrl+Shift+I），切换到 Console 标签页，看是否有Failed to activate package或Cannot find module报错 - 运行
apm list --packages --installed | grep linter，输出应为linter@2.3.0（注意不是linter@2.3.0-0这类带后缀的临时版本） - 检查插件目录下是否存在
node_modules/season、node_modules/atom-linter等关键依赖子目录；缺失说明apm install --production没跑成功
最容易被忽略的一点：旧版插件可能依赖已废弃的 Atom API（如 TextEditor::onDidChangePath），而新 Atom（v1.70+）已移除。此时即使安装成功，功能也会静默失效——必须查插件 README 的 engines.atom 字段，严格匹配 Atom 小版本。
