解决Angular 14上游依赖冲突（禁用--legacy-peer-deps/--force）

错误根本原因 #

npm v7及以上版本默认启用严格Peer依赖校验机制，Angular 14对核心依赖（如@angular/core、@angular/common等）有明确的版本要求（^14.x.x）。当你安装的第三方库声明的Peer依赖版本范围与当前项目的Angular版本不兼容，或者库之间的Peer依赖存在交叉冲突时，npm无法自动解析出兼容的依赖树，就会抛出这类冲突错误。

解决步骤 #

1. 定位具体冲突依赖 #

执行以下命令，获取完整的依赖冲突详情：

npm install --dry-run

从输出中找到明确标记为"conflicting peer dependency"的库，确定是哪个第三方库与Angular 14的依赖版本不匹配。

2. 安装库的Angular 14兼容版本 #

针对冲突的库，查询其官方版本适配文档，找到支持Angular 14的版本号，执行指定版本安装：

# 示例：安装适配Angular14的ngx-bootstrap@11.x版本
npm install ngx-bootstrap@11.0.2

常见库的Angular 14适配版本参考：

• ngx-bootstrap: 11.x.x
• ng-zorro-antd: 14.x.x
• PrimeNG: 14.x.x

3. 清理依赖环境重新安装 #

如果仍有冲突，清理现有依赖缓存后重新构建依赖树：

# 删除node_modules和锁文件
rm -rf node_modules package-lock.json
# 清理npm缓存
npm cache clean --force
# 重新安装依赖
npm install

4. 统一项目核心依赖版本 #

检查package.json文件，确保所有Angular核心包（@angular/core、@angular/common、@angular/router等）的版本号完全一致，避免项目内部依赖版本不一致引发的连锁冲突。

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