Angular 7升级至14时无法更新Angular Material，如何使用本地CLI？

核心问题原因 #

执行ng update时，Angular CLI默认会检测全局CLI版本，若不是最新稳定版则自动安装临时高版本CLI，而高版本CLI要求更高的Node.js版本，这就触发了你遇到的版本不兼容错误。要解决这个问题，关键是强制使用本地已安装的Angular CLI 8.3.29，跳过临时CLI的自动安装。

具体解决方法 #

方法1：通过环境变量禁用版本检查，用本地CLI执行更新 #

先设置环境变量跳过CLI版本检查，再调用本地CLI执行更新命令：

• Windows CMD：

  set NG_DISABLE_VERSION_CHECK=1
  .\node_modules\.bin\ng update @angular/material@8 --force
  

• Windows PowerShell：

  $env:NG_DISABLE_VERSION_CHECK=1
  .\node_modules\.bin\ng update @angular/material@8 --force
  

• Linux/macOS：

  NG_DISABLE_VERSION_CHECK=1 ./node_modules/.bin/ng update @angular/material@8 --force
  

说明：--force参数用于跳过版本冲突校验，若你的代码已提交无未修改内容，可去掉--allow-dirty（若命令提示需要则加上）。

方法2：手动修改依赖版本后安装 #

如果命令行方式仍有问题，可直接修改配置文件手动更新：

1. 打开项目根目录的package.json，找到@angular/material、@angular/cdk（Material依赖CDK，版本必须与Material一致），将版本号改为^8.2.3（Angular 8对应的最新Material稳定版）。
2. 执行本地npm安装命令：

   .\node_modules\.bin\npm install
   

注意事项 #

• 确保@angular/core版本与@angular/material版本严格匹配（均为8.x系列），Angular Material版本必须和Angular核心框架版本一致。
• 更新完成后，运行ng serve验证项目是否正常启动，检查控制台报错并修复Material组件的API兼容问题（比如部分组件的输入输出属性变化）。

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