Angular版本与CLI不兼容及peer依赖冲突问题咨询

当前使用的Angular CLI版本仅兼容Angular ^17.0.0，但项目依赖的Angular版本为11.0.9，引发依赖解析冲突，报错信息如下：

npm ERR! 无法解析依赖项：
npm ERR! 来自@angular/core@11.0.9的peer依赖zone.js@"~0.10.3"
npm ERR! node_modules/@angular/core
npm ERR! 根项目中的@angular/core@"~11.0.9"
npm ERR! 来自@angular-material-extensions/select-country@4.3.0的peer依赖@angular/core@"^11.0.2"
npm ERR! node_modules/@angular-material-extensions/select-country
npm ERR! 根项目中的@angular-material-extensions/select-country@"^4.0.3"
npm ERR! 另外2个依赖项（@angular/cdk, @angular/common）
npm ERR!
npm ERR! 请修复上游依赖冲突，或使用--force或--legacy-peer-deps参数重试该命令
npm ERR! 以接受不正确（且可能存在问题）的依赖解析结果。

方案1：匹配CLI与项目Angular版本 #

Angular CLI版本必须和项目的Angular核心版本保持兼容，11.x项目需要使用对应版本的CLI：

• 全局安装Angular 11.x版本的CLI：

  npm install -g @angular/cli@11
  

• 本地项目同步安装对应版本：

  npm install --save-dev @angular/cli@11
  

方案2：临时跳过依赖冲突（不推荐用于生产环境） #

如果只是临时需要执行命令，可使用npm提供的参数绕过peer依赖检查：

• 使用--legacy-peer-deps（推荐，采用npm v6的依赖解析逻辑）：

  npm install --legacy-peer-deps
  

• 或使用--force（强制忽略冲突，可能引入不稳定依赖）：

  npm install --force
  

方案3：升级项目到Angular 17（长期解决方案） #

如果项目允许，可逐步升级Angular版本到17.x，确保CLI和核心版本兼容：

1. 按照Angular官方升级指南，从11.x逐步升级到17.x
2. 升级过程中同步更新依赖包（如@angular-material-extensions/select-country需升级到支持Angular 17的版本）

内容的提问来源于stack exchange，提问作者Golden hills Ranjith