Angular CLI版本不兼容报错求助：仅适配Angular13，当前为14.2.12

环境信息 #

• 全局CLI版本（截图）：ng version
• 项目CLI版本（截图）：ng version
• 项目package.json配置：

"dependencies": {
  "@angular/animations": "^14.2.12",
  "@angular/common": "^14.2.12",
  "@angular/compiler": "^14.2.12",
  "@angular/core": "^14.2.12",
  "@angular/forms": "^14.2.12",
  "@angular/platform-browser": "^14.2.12",
  "@angular/platform-browser-dynamic": "^14.2.12",
  "@angular/router": "^14.2.12",
  "angular-component-library": "16.0.0-beta.1",
  "rxjs": "^7.4.0",
  "tslib": "^2.3.0",
  "zone.js": "~0.11.4"
},
"devDependencies": {
  "@angular-devkit/build-angular": "~13.3.2",
  "@angular/cli": "~15.0.4",
  "@angular/compiler-cli": "~15.0.4",
  "@types/jasmine": "~3.10.0",
  "@types/node": "^12.11.1",
  "jasmine-core": "~4.0.0",
  "karma": "~6.3.0",
  "karma-chrome-launcher": "~3.1.0",
  "karma-coverage": "~2.1.0",
  "karma-jasmine": "~4.0.0",
  "karma-jasmine-html-reporter": "~1.7.0",
  "ts-node": "~7.0.0",
  "tslint": "~5.15.0",
  "typescript": "~4.6.2"
}

报错信息 #

此版本的CLI仅兼容Angular版本^13.0.0 || ^13.3.0-rc.0，但当前检测到的Angular版本为14.2.12。

解决方案 #

1. 统一CLI工具链与核心框架版本 #

项目核心依赖是Angular 14.2.12，但devDependencies里的@angular/cli、@angular/compiler-cli为15.x，@angular-devkit/build-angular为13.x，版本严重不匹配是报错核心原因。执行以下命令安装匹配版本：

# 卸载当前项目的CLI相关依赖
npm uninstall @angular/cli @angular/compiler-cli @angular-devkit/build-angular --save-dev

# 安装Angular 14.x对应的CLI工具链
npm install @angular/cli@~14.2.0 @angular/compiler-cli@~14.2.12 @angular-devkit/build-angular@~14.2.0 --save-dev

2. 处理第三方组件库兼容性问题 #

当前使用的angular-component-library@16.0.0-beta.1是为Angular 16设计的，与Angular 14存在兼容性风险，建议：

• 降级该组件库到支持Angular 14的稳定版本
• 若业务允许，将整个项目升级至Angular 16版本

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

# 删除node_modules和锁文件
rm -rf node_modules package-lock.json

# 重新安装依赖
npm install

4. 使用项目本地CLI执行命令 #

避免全局CLI版本干扰，执行项目本地的命令：

npx ng serve

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