如何将Angular Material 16.0.0降级至14.2.6以适配现有项目

核心前提 #

Angular Material版本必须与Angular核心框架版本严格匹配，14.2.6的Material对应Angular 14.2.x系列版本，所以需要同步降级项目的Angular核心依赖与Material组件库。

具体操作步骤 #

1. 进入项目根目录 #

确保你在项目的根文件夹下执行所有命令，而非全局环境。

2. 卸载当前的Material与CDK #

npm uninstall @angular/material @angular/cdk

3. 安装指定版本的Material与CDK #

npm install @angular/material@14.2.6 @angular/cdk@14.2.6 --save

4. 同步降级Angular核心依赖 #

安装与Material版本匹配的Angular核心包（将14.2.x替换为具体的小版本，比如14.2.12，确保兼容性）：

npm install @angular/core@14.2.x @angular/common@14.2.x @angular/compiler@14.2.x @angular/cli@14.2.x @angular/platform-browser@14.2.x @angular/platform-browser-dynamic@14.2.x @angular/router@14.2.x --save

5. 清理缓存并重新安装依赖 #

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

6. 验证版本正确性 #

执行命令确认依赖版本：

ng version

检查输出中@angular/material和@angular/core是否均为14.x系列。

兼容性检查 #

• 组件API：Angular 16到14存在部分API废弃或调整，需检查项目中使用的Material组件代码，替换过时用法（比如某些组件的输入输出属性变更）。
• 动画：确保BrowserAnimationsModule已正确导入到根模块，若动画异常，可检查组件的动画配置是否适配14版本的API。

之前操作无效的原因 #

你仅降级了全局的@angular/cli，但项目本地的package.json依赖和node_modules并未更新，项目仍在使用原有的高版本库。只有修改项目本地的依赖配置，才能真正生效。

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