Angular 17.3新项目启动报错：spawn UNKNOWN（Node.js 18.16环境）

问题场景 #

已安装 Node.js v18.16.1，升级至 Angular v17.3；通过 ng new 创建空白基础项目后执行 ng serve，出现如下错误：

[error] Error: spawn UNKNOWN
    at ChildProcess.spawn (node:internal/child_process:413:11)
    at Object.spawn (node:child_process:757:9)
    at ensureServiceIsRunning (C:\Repos\HolocaustSurvivorsInterfaces\mlm-app\node_modules\esbuild\lib\main.js:2164:29)
    at context (C:\Repos\HolocaustSurvivorsInterfaces\mlm-app\node_modules\esbuild\lib\main.js:2048:33)
    at #performBundle (C:\Repos\HolocaustSurvivorsInterfaces\mlm-app\node_modules\@angular-devkit\build-angular\src\tools\esbuild\bundler-context.js:158:68)
    at BundlerContext.bundle (C:\Repos\HolocaustSurvivorsInterfaces\mlm-app\node_modules\@angular-devkit\build-angular\src\tools\esbuild\bundler-context.js:132:49)
    at C:\Repos\HolocaustSurvivorsInterfaces\mlm-app\node_modules\@angular-devkit\build-angular\src\tools\esbuild\bundler-context.js:65:28
    at Array.map (<anonymous>)
    at BundlerContext.bundleAll (C:\Repos\HolocaustSurvivorsInterfaces\mlm-app\node_modules\@angular-devkit\build-angular\src\tools\esbuild\bundler-context.js:61:67)
    at executeBuild (C:\Repos\HolocaustSurvivorsInterfaces\mlm-app\node_modules\@angular-devkit\build-angular\src\builders\application\execute-build.js:40:67)

解决方法 #

• 清理并重装依赖：删除项目根目录的 node_modules 和 package-lock.json 文件，执行 npm install 后重试 ng serve
• 单独重装 esbuild：该错误直接关联 esbuild 服务启动失败，执行以下命令修复：

  npm uninstall esbuild
  npm install esbuild@latest
  

• 验证 Node 版本兼容性：Angular 17 推荐 Node 18.13+ 或 20.x，可升级到 Node 18.x 最新稳定版或切换到 Node 20.x（使用 nvm 切换版本更便捷）
• 检查 Windows 权限：以管理员身份打开终端执行 ng serve，或临时关闭杀毒软件/防火墙排除拦截
• 清除 Angular CLI 缓存：执行 ng cache clean 后重试
• 重新创建项目测试：若以上方法无效，尝试 ng new test-app 创建新空白项目，验证是否为当前项目配置异常

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