使用npm create vite@latest创建React项目失败：无法初始化项目

可行解决方案 #

• 清理依赖与缓存
  删除项目内的node_modules、package-lock.json文件，执行以下命令：

  npm cache clean --force
  npm install
  

• 锁定esbuild稳定版本
  安装与Node.js 20.x兼容的esbuild版本：

  npm install esbuild@0.19.11 --save-dev
  

• 修改Vite配置禁用esbuild服务模式
  在项目根目录的vite.config.js中添加配置：

  import { defineConfig } from 'vite'
  import react from '@vitejs/plugin-react'
  
  export default defineConfig({
    plugins: [react()],
    esbuild: {
      worker: false
    }
  })
  

• 修正项目路径
  移除路径中的空格或特殊字符（如将Java Script改为JavaScript），避免路径解析异常。

• 切换包管理器
  尝试用pnpm或yarn重新创建项目：

  # 使用pnpm
  pnpm create vite@latest my-react-app --template react
  # 使用yarn
  yarn create vite my-react-app --template react
  

错误原因说明 #

该错误由esbuild服务意外终止引发，常见诱因包括：路径含特殊字符、依赖版本不匹配、缓存损坏、文件权限不足等。

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