VS Code中无法创建React App：spawn UNKNOWN错误解决（Node 17/18）

报错信息 #

Aborting installation.
Unexpected error. Please report it as a bug:
Error: spawn UNKNOWN
at ChildProcess.spawn (node:internal/child_process:413:11)
at Object.spawn (node:child_process:757:9)
at spawn (C:\Users\bhumi\AppData\Local\npm-cache_npx\c67e74de0542c87c\node_modules\cross-spawn\index.js:12:24)
at C:\Users\bhumi\AppData\Local\npm-cache_npx\c67e74de0542c87c\node_modules\create-react-app\createReactApp.js:383:19
at new Promise ()
at install (C:\Users\bhumi\AppData\Local\npm-cache_npx\c67e74de0542c87c\node_modules\create-react-app\createReactApp.js:334:10)
at C:\Users\bhumi\AppData\Local\npm-cache_npx\c67e74de0542c87c\node_modules\create-react-app\createReactApp.js:461:16
at process.processTicksAndRejections (node:internal/process/task_queues:95:5) {
errno: -4094,
code: 'UNKNOWN',
syscall: 'spawn'
}

解决方案 #

针对Node.js 17/18版本出现的该错误，可尝试以下方法：

• 清理npm缓存后重试
  执行命令清理缓存：npm cache clean --force
  重新运行创建命令：npx create-react-app my-app（替换my-app为你的项目名称）

• 添加legacy-peer-deps参数
  Node.js 17+版本的npm对peer依赖校验更严格，添加该参数可绕过兼容性限制：
  npx create-react-app my-app --legacy-peer-deps

• 检查权限与路径

  • 确保VS Code以管理员身份运行，避免权限不足导致进程启动失败
  • 项目路径不要包含中文、空格或特殊字符，建议使用纯英文路径

• 降级到Node.js LTS版本
  若上述方法无效，可降级到Node.js 16.x LTS版本：卸载当前版本后，下载对应LTS安装包重新安装，再执行创建命令

• 改用Vite创建项目
  create-react-app已停止维护，Vite是更现代的替代方案：

  npm create vite@latest my-app -- --template react
  cd my-app
  npm install
  npm run dev
  

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