Angular 卡在10.2版本无法升级至11版本求助

问题现象 #

执行ng update @angular/cli@11和ng update @angular/core@11后，命令输出显示已更新package.json中的依赖版本，但再次执行ng update时，仍提示需要从10.2.x升级到11.2.x，当前使用Node.js版本为v20.12.2。

可能原因及解决方法 #

• Node.js版本不兼容
  Angular 11仅支持Node.js 10.13.0+、12.x、14.x（LTS版本），v20.12.2版本过高，会导致npm安装依赖时出现隐性异常，或Angular CLI无法正确识别已安装的包版本。
  解决步骤：

  1. 使用Node版本管理器（如nvm）切换到Angular 11兼容的Node版本，比如14.x LTS。
  2. 删除项目根目录的node_modules文件夹和package-lock.json文件。
  3. 执行npm install重新安装依赖，再运行ng update @angular/cli@11 @angular/core@11。

• npm缓存或安装不完整
  即使命令显示安装成功，也可能存在依赖安装不完整、缓存冲突的情况，导致Angular CLI无法读取正确的版本信息。
  解决步骤：

  1. 清理npm缓存：npm cache clean --force
  2. 删除node_modules和package-lock.json。
  3. 重新安装依赖：npm install
  4. 带--force参数执行升级命令：ng update @angular/cli@11 @angular/core@11 --force（跳过部分兼容性检查，适合跨小版本升级）

• 全局Angular CLI版本干扰
  若全局安装的Angular CLI仍为10.x版本，执行ng update时会优先使用全局版本，而非项目本地的11.x版本，导致版本检测异常。
  解决步骤：

  1. 查看全局CLI版本：ng --version
  2. 卸载全局旧版本CLI：npm uninstall -g @angular/cli
  3. 安装11.x版本的全局CLI：npm install -g @angular/cli@11
  4. 回到项目目录重新执行升级命令。

• package.json未正确更新或读取
  检查项目根目录的package.json，确认@angular/cli、@angular/core等核心依赖的版本是否已改为11.x。若命令显示更新但实际文件未变化，可能是权限问题或编辑器缓存导致。
  解决步骤：

  1. 手动打开package.json，将相关Angular依赖版本修改为11.2.19（或命令输出中显示的目标版本）。
  2. 保存文件后，删除node_modules和package-lock.json，执行npm install。

内容的提问来源于stack exchange，提问作者Darkreaper