Angular 17+Nx项目构建报错：无法找到@nx/workspace:run-commands执行器

核心原因及解决方案 #

1. 执行器包路径变更 #

Nx 17版本对执行器的归属包做了调整，原@nx/workspace:run-commands执行器已迁移至@nx/devkit包下。需要修改项目配置中的执行器地址：

将配置片段里的：

"executor": "@nx/workspace:run-commands"

替换为：

"executor": "@nx/devkit:run-commands"

2. 依赖完整性问题 #

尽管package.json已包含对应Nx依赖，但仍可能存在依赖安装不完整或文件损坏的情况，可尝试重新安装依赖：

rm -rf node_modules package-lock.json
npm install

（若使用pnpm或yarn，替换为对应清理重装命令）

3. Nx缓存残留 #

版本升级后可能存在旧配置缓存干扰，执行以下命令清理Nx缓存：

nx reset

清理完成后重新执行构建命令。

附相关信息 #

报错信息：

Cannot find executor 'run-commands' in C:\Users\tamart\Desktop\build-UI\ui-build\node_modules\@nx\workspace\executors.json.

原配置片段：

"executor": "@nx/workspace:run-commands",
"options": {
  "commands": [
    "nx run node-gateway-autologin:build-main",
    "ts-node-script ./build/bundle-lib.ts bundle libs/node-gateway-autologin dist/libs/node-gateway-autologin"
  ],
  "parallel": false
},
"configurations": {}

更新后的package.json依赖：

"private": true,
"dependencies": {
  "@angular-devkit/schematics": "17.1.4",
  "@angular/animations": "17.1.3",
  "@angular/common": "17.1.3",
  "@angular/compiler": "17.1.3",
  "@angular/core": "17.1.3",
  "@angular/forms": "17.1.3",
  "@angular/platform-browser": "17.1.3",
  "@angular/platform-browser-dynamic": "17.1.3",
  "@angular/router": "17.1.3",
  "antlr4": "^4.9.3",
  "debug": "^4.3.2",
  "rxjs": "~6.6.0",
  "tslib": "^2.0.0",
  "zone.js": "0.14.8"
},
"devDependencies": {
  "@angular-devkit/build-angular": "17.1.4",
  "@angular/compiler-cli": "17.1.3",
  "@angular/language-service": "17.1.3",
  "@nrwl/tao": "17.3.2",
  "@nx/angular": "17.3.2",
  "@nx/eslint": "17.3.2",
  "@nx/eslint-plugin": "17.3.2",
  "@nx/jest": "17.3.2",
  "@nx/node": "17.3.2",
  "@nx/workspace": "17.3.2",
  "@openapitools/openapi-generator-cli": "^2.4.13",
  "@types/superagent": "^4.1.13",
  "@typescript-eslint/eslint-plugin": "6.13.2",
  "@typescript-eslint/parser": "6.13.2",
  "autoprefixer": "^10.4.0",
  "commander": "^8.3.0",
  "concurrently": "^6.5.0",
  "eslint": "8.48.0",
  "eslint-config-prettier": "9.0.0",
  "jest": "29.4.3",
  "jest-environment-jsdom": "~28.1.1",
  "ng-packagr": "17.1.2",
  "ng-swagger-gen": "^2.3.1",
  "nx": "17.3.2",
  "nx-remotecache-custom": "^1.0.0",
  "ts-node": "10.9.1",
  "typescript": "5.3.3"
}

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