Vite+Vue项目执行npm run dev报错：Failed to scan for dependencies

错误日志 #

执行npm run dev后出现如下错误：

VITE v5.4.3  ready in 949 ms

➜  Local:   http://localhost:3000/
➜  Network use --host to expose

Error: Failed to scan for dependencies from entries:
C:/xampp/htdocs/fill rouge/my-vue-resourceHub/index.html

The service was stopped: write EPIPE
    at C:\xampp\htdocs\fill rouge\my-vue-resourceHub\node_modules\vite\node_modules\esbuild\lib\main.js:993:26
    at responseCallbacks.<computed> (C:\xampp\htdocs\fill rouge\my-vue-resourceHub\node_modules\vite\node_modules\esbuild\lib\main.js:622:9)
    at afterClose (C:\xampp\htdocs\fill rouge\my-vue-resourceHub\node_modules\vite\node_modules\esbuild\lib\main.js:613:28)
    at onwriteError (node:internal/streams/writable:597:3)
    at process.processTicksAndRejections (node:internal/process/task_queues:84:21)

已尝试的排查步骤 #

• 删除node_modules并重新安装依赖：执行rm -rf node_modules和npm install，问题未解决
• 检查vite.config.js：未发现路径或入口相关配置问题
• 确认项目结构：index.html位于根目录，src/目录包含Vue组件，结构正常

项目信息 #

• Vite版本：v5.4.3
• Node版本：[请替换为你的Node版本，例如v20.15.0]
• npm版本：[请替换为你的npm版本，例如v10.8.1]
• 操作系统：Windows 10
• 目录结构：[请提供简要概述，如根目录包含index.html、src/、package.json等]

可能的解决方案 #

• 修改项目路径：当前项目路径包含空格（fill rouge），Esbuild对带空格的路径兼容性较差，建议将目录名改为无空格格式（如fill-rouge），重新执行npm run dev
• 检查端口占用：3000端口可能被其他进程占用，执行命令netstat -ano | findstr :3000查看占用进程，通过任务管理器终止对应进程后重试
• 指定Esbuild版本：Vite依赖的Esbuild版本可能与Node版本不兼容，在package.json中添加"esbuild": "^0.21.0"，执行npm install后重新启动服务
• 清理npm缓存：执行npm cache clean --force清除缓存，再重新安装依赖并启动
• 提升终端权限：Windows下右键终端选择「以管理员身份运行」，再执行npm run dev，避免权限不足导致的文件写入错误

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