apm upgrade 默认不升级指定包，因其仅升级满足引擎约束且有 patch/minor 更新的包，不跨 major 版本，也不覆盖手动锁定版本；apm install 则重装并自动匹配最高兼容版，但可能丢失配置。
apm upgrade 默认不升级指定包，这是最容易被当成“bug”的行为。
为什么 apm upgrade package-name 没反应？
因为 apm upgrade 的设计逻辑是：只升级满足引擎约束（engines.atom）且有 patch/minor 版本更新的包，不会跨 major 版本升级，也不会覆盖被手动锁定的版本。
- 执行
apm upgrade linter-eslint时，如果当前装的是8.6.0，而最新兼容版是8.6.1，它会升级；但如果最新版是9.0.0且engines.atom要求 ≥1.70，而你用的是 1.63.1，它就静默跳过 - 若该包曾用
apm install linter-eslint@8.5.0锁定版本，apm upgrade不会动它——这不是 bug，是语义设计 - 想强制升级到最新兼容版？别用
upgrade，改用apm install linter-eslint（重装，但会自动选匹配你 Atom 版本的最高可用版）
apm install 和 apm upgrade 在升级场景下怎么选？
两者目的不同，误用会导致配置丢失或版本错乱。
-
apm upgrade linter-eslint：仅更新已有安装，保留用户配置、禁用状态、自定义设置 -
apm install linter-eslint：重新下载并覆盖安装，可能清空本地修改过的 config.cson 片段（尤其当包带默认配置文件时） - 升级失败后常见错误操作：反复
apm install→ 实际只是不断重装同一旧版，因 registry 返回的仍是兼容版 - 真正要换大版本？先
apm uninstall linter-eslint，再apm install linter-eslint@latest（注意：@latest 可能不兼容，务必先查apm show linter-eslint看支持范围）
升级卡住或报 “No available version compatible” 怎么办？
这不是网络问题，是版本锁死信号——插件作者已停止维护，或你 Atom 版本太新/太旧。
- 第一步：运行
atom --version确认当前版本（2026 年主流为 1.63.x） - 第二步：访问
https://atom.io/packages/linter-eslint，看右下角 “Compatible with Atom x.y.z” 是否覆盖你当前版本 - 第三步：若不兼容，别硬试
@1.2.3——engines.atom字段会直接拒绝安装 - 可行路径只有两个：换兼容的 Atom 版本（如降级到 1.58），或换替代插件（比如
linter-eslint失效时，atom-ide-ui + ide-eslint是更现代的组合）
离线环境怎么安全升级插件？
内网机器不能走 registry，但直接解压覆盖会破坏 node_modules 依赖树。
- 正确做法：下载对应版本的
.tgz包（必须是 GitHub Releases 或 archive.org 上的官方构建产物，不是.zip或源码） - 命令：
apm install /path/to/linter-eslint-8.6.1.tgz - 关键点：
apm install会自动触发 rebuild，但前提是.tgz内含预编译的 native 模块（否则需本地有 Python + node-gyp） - 升级后验证：运行
apm list --packages --installed | grep linter-eslint，确认版本号和路径是否更新
apm upgrade 命令背后，实际在检查 dozens 个字段，稍有不匹配就静默放弃——这恰恰是它稳定的原因，也是用户最容易忽略的细节。 
