执行ng build时Angular CLI与Angular版本兼容性报错问题

执行ng build时出现报错：
当前CLI版本仅兼容Angular版本^13.0.0 || ^13.3.0-rc.0，但实际检测到的Angular版本为18.2.10。

当前环境版本信息 #

Angular CLI: 18.2.11
Node: 22.11.0
Package Manager: npm 10.9.0
OS: darwin arm64

Angular: 18.2.10
... animations, common, compiler, compiler-cli, core, forms
... platform-browser, platform-browser-dynamic, router

Package                         Version
---------------------------------------------------------
@angular-devkit/architect       0.1303.11
@angular-devkit/build-angular   18.2.11
@angular-devkit/core            13.3.11
@angular-devkit/schematics      18.2.11
@angular/cdk                    18.2.11
@angular/cli                    18.2.11
@angular/material               18.2.11
@schematics/angular             18.2.11
rxjs                            7.5.7
typescript                      5.5.4
webpack                         5.95.0
zone.js                         0.14.10

问题原因 #

从依赖列表能明显看到，@angular-devkit/architect和@angular-devkit/core两个核心DevKit包停留在13.x版本，但Angular CLI、框架主体及其他DevKit相关包已经升级到18.x，版本不一致触发了CLI的兼容性检测逻辑，导致报错。

解决步骤 #

• 卸载旧版本的DevKit核心包：

  npm uninstall @angular-devkit/architect @angular-devkit/core
  

• 安装与当前CLI版本匹配的18.x版本DevKit包：

  npm install @angular-devkit/architect@18.2.11 @angular-devkit/core@18.2.11 --save-dev
  

• 重新执行构建命令验证：

  ng build
  

补充处理（若遇依赖冲突） #

如果安装过程中出现依赖冲突提示，可先清理npm缓存再重新安装所有依赖：

npm cache clean --force
npm install

内容的提问来源于stack exchange，提问作者A.Mac