Angular项目启动遇循环报错：无法找到@angular-devkit/build-angular:dev-server

问题现象 #

• 安装js-cookie时提示缺失@angular-devkit/build-angular，安装该dev依赖时又提示缺失js-cookie，陷入依赖安装循环
• 执行yarn start时抛出错误：Could not find the '@angular-devkit/build-angular:dev-server' builder's node package

解决方案 #

1. 清理依赖环境 #

先彻底清理现有依赖残留，避免版本冲突：

• 删除项目根目录下的node_modules文件夹
• 删除yarn.lock锁文件
• 清理Yarn本地缓存：

  yarn cache clean
  

2. 统一依赖版本并重新安装 #

注意到你安装@angular-devkit/build-angular时指定了~0.17.0，但依赖配置中实际是^17.3.8，Angular 17对应的该依赖主版本应为17.x（而非0.17.x），版本不匹配是核心问题之一。执行以下命令重新安装：

# 先安装生产依赖js-cookie
yarn add js-cookie
# 安装与Angular版本匹配的build依赖
yarn add @angular-devkit/build-angular@17.3.8 --dev
# 或直接让Yarn自动同步所有依赖
yarn install

3. 验证Angular构建配置 #

检查项目根目录的angular.json文件，确认serve任务的builder配置正确：

"architect": {
  "serve": {
    "builder": "@angular-devkit/build-angular:dev-server",
    "options": {
      "browserTarget": "你的项目名称:build"
    }
  }
}

4. 对齐CLI与本地依赖版本 #

从ng version输出看，@angular/cli和@angular-devkit/build-angular标记为cli-only，说明全局CLI与本地依赖存在版本差异，安装与本地build依赖同版本的CLI：

yarn add @angular/cli@17.3.8 --dev

相关信息参考 #

安装命令 #

yarn add @angular-devkit/build-angular@~0.17.0 --dev 
yarn add js-cookie

依赖配置片段 #

{
  "dependencies": {
    "js-cookie": "^3.0.5"
  },
  "devDependencies": {
    "@angular-devkit/architect": "0.1703.8",
    "@angular-devkit/build-angular": "^17.3.8",
    "@angular-devkit/core": "^17.3.8",
    "@angular-devkit/schematics": "^17.3.8",
    "@angular-eslint/builder": "^17.3.8"
  }
}

启动报错日志 #

> yarn start
yarn run v1.22.19
$ ng serve --hmr
Error: Could not find the '@angular-devkit/build-angular:dev-server' builder's node package.
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

ng version输出 #

@angular-devkit/architect       0.1703.8 (cli-only)
@angular-devkit/build-angular   17.3.8 (cli-only)
@angular-devkit/core            17.3.8
@angular-devkit/schematics      17.3.8
@angular/cdk                    17.3.10
@angular/cli                    17.3.8 (cli-only)
@schematics/angular             17.3.8
rxjs                            7.8.1
typescript                      5.4.5
zone.js                         0.14.7

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