为Ionic项目添加Android时遭遇npm peer依赖冲突问题求助

核心问题本质 #

你的项目基于Angular 10.2.5，但当前安装的@angular-devkit/build-angular@15.2.6是Angular 15专属的构建工具，跨5个大版本的版本差异完全无法兼容，--legacy-peer-deps只是强制跳过依赖校验，无法解决底层兼容性问题，后续必然出现运行时错误。

具体解决步骤 #

1. 对齐构建工具与Angular核心版本 #

安装与你的Angular 10.2.5匹配的构建工具版本，这是最直接的临时修复方案：

npm install @angular-devkit/build-angular@~10.2.0 --save-dev

若安装时仍有依赖报错，可附加--force或--legacy-peer-deps完成安装，但这只是权宜之计，长期建议升级版本。

2. 校验Ionic CLI与Angular的兼容性 #

Ionic与Angular版本绑定严格，Angular 10对应Ionic 5系列。先查看当前Ionic版本：

ionic --version

如果是Ionic 6及以上版本，需降级到兼容版本：

npm install -g @ionic/cli@5.4.16

确保Ionic、Angular、Node.js三者版本处于同一兼容区间。

3. 清理缓存并重装依赖 #

残留缓存可能导致依赖安装异常，执行以下操作：

• 删除项目根目录的node_modules文件夹和package-lock.json文件
• 清理npm缓存：

npm cache clean --force

• 重新安装依赖：

npm install

4. 逐步升级Angular版本（长期推荐方案） #

若项目允许，建议逐步升级Angular到15版本（与构建工具版本匹配），避免跨大版本升级的风险：

1. 升级到Angular 11：

ng update @angular/core@11 @angular/cli@11

2. 依次升级到12、13、14，最终到15：

ng update @angular/core@12 @angular/cli@12
ng update @angular/core@13 @angular/cli@13
ng update @angular/core@14 @angular/cli@14
ng update @angular/core@15 @angular/cli@15

每次升级后验证依赖正常，解决小问题后再进行下一次升级。

5. 同步其他依赖版本 #

检查package.json中如@ionic/angular、@angular/material等依赖的版本，确保它们与当前Angular版本兼容，同步调整版本号后重新安装。

验证修复 #

完成上述步骤后，尝试重新添加Android平台：

ionic capacitor add android

若仍报错，查看错误日志定位其他冲突依赖，针对性调整。

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