使用Vite创建React应用时出现依赖扫描失败错误求助

在Windows系统上使用Vite创建React应用时启动失败，报错信息如下：

Error: Failed to scan for dependencies from entries: C:/Users/User/Desktop/responsive-app/index.html
at C:\Users\User\Desktop\responsive-app\node_modules\esbuild\lib\main.js:1083:25
at sendRequest (C:\Users\User\Desktop\responsive-app\node_modules\esbuild\lib\main.js:699:14)
at buildOrContextContinue (C:\Users\User\Desktop\responsive-app\node_modules\esbuild\lib\main.js:1081:5)
at C:\Users\User\Desktop\responsive-app\node_modules\esbuild\lib\main.js:993:11
error Command failed with exit code 1.

已尝试删除node_modules重装依赖、手动安装esbuild，问题仍未解决。

1. 检查项目路径兼容性 #

Windows系统下esbuild对路径中的中文、空格、特殊符号（如&、#）兼容性差。确认项目路径C:/Users/User/Desktop/responsive-app是否包含这类字符，若有，将项目迁移到纯英文无空格路径，比如C:\Projects\responsive-app。

2. 配置Vite强制指定Windows平台 #

在项目根目录的vite.config.js（或vite.config.ts）中添加平台配置：

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  build: {
    platform: 'win32'
  },
  optimizeDeps: {
    esbuildOptions: {
      platform: 'win32'
    }
  }
})

3. 彻底清理缓存并重装依赖 #

执行以下命令：

# Windows命令行清理Vite缓存
rmdir /s /q node_modules\.vite

# 清理Yarn缓存
yarn cache clean

# 重装依赖
yarn install

4. 锁定esbuild兼容版本 #

部分新版本esbuild在Windows存在兼容性问题，降级到稳定版本：

yarn add esbuild@0.17.19 --dev

5. 检查index.html合法性 #

确认index.html的脚本引用无错误：

• 确保type="module"的脚本路径正确
• 无不存在的本地文件引用
• 无语法错误

示例正确入口：

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Vite + React</title>
  </head>
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.jsx"></script>
  </body>
</html>

6. 更换包管理器尝试 #

若Yarn问题持续，改用npm：

rm -rf node_modules yarn.lock
npm install
npm run dev

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