Angular CLI新项目中无法安装Angular Material，求报错解决方法

嘿，我在Stack Overflow上帮不少开发者搞定过这类安装问题，你碰到的报错大概率和版本不兼容有关，当然也有其他几个常见诱因，我给你一步步拆解排查和解决方法：

1. 先盯紧版本匹配（最常见原因） #

Angular Material、Angular CDK和你的Angular核心框架版本必须完全对齐，哪怕小版本差一个号都可能触发依赖冲突。你已经检查过Angular版本，那可以再确认下：

ng version

找到输出里的Angular CLI和@angular/core版本号，比如是17.2.3，那安装时就得指定完全一致的Material/CDK版本：

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

要是不确定对应关系，记住一个原则：Material的主版本号必须和Angular主版本号完全相同（比如Angular 16对应Material 16，Angular 17对应Material 17）。

2. 清理缓存再重装试试 #

有时候npm缓存的旧依赖包会搞事情，试试这套“重置”操作：

# 强制清理npm缓存
npm cache clean --force
# 删除本地依赖包和锁文件（Windows用户把第一句换成 rmdir /s /q node_modules）
rm -rf node_modules package-lock.json
# 重新安装基础依赖
npm install
# 再安装匹配版本的Material和CDK
npm install --save @angular/material@你的版本号 @angular/cdk@你的版本号

3. 升级npm到稳定版 #

过旧的npm版本可能解析不了新的依赖规则，建议升级到最新稳定版：

npm install -g npm@latest

4. 处理Peer依赖冲突（如果报错明确提这个） #

如果报错里出现peer dependency conflict这类字眼，临时可以用--legacy-peer-deps参数绕过，但这只是权宜之计，长期来看还是要把版本对齐：

npm install --save @angular/material @angular/cdk --legacy-peer-deps

5. 确认CLI版本和项目一致 #

全局Angular CLI版本和本地项目CLI版本不一致也可能引发奇怪问题，检查本地版本：

npx ng version

如果和全局版本差得远，先更新本地CLI和核心框架：

ng update @angular/cli @angular/core

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