启动Vite开发服务器报错：无法找到指定依赖文件

环境信息 #

• Node.js: v18.12.1
• React: ^18.2.0
• Vite: ^4.4.9

问题现象 #

启动开发服务器时，Vite创建空缓存目录，未生成deps_temp相关文件，报错：

[ERROR] Failed to write to output file: open C:\Users\User\Project\node_modules.vite\deps_temp_14dh04e8\react_jsx-dev-runtime.js: The system cannot find the file specified

npm run build和npm run preview执行正常，已尝试删除node_modules重装依赖、使用--force参数，问题未解决。

解决方案 #

1. 手动清理Vite缓存目录 #

直接删除Vite默认缓存目录node_modules/.vite，再重启开发服务器：

# macOS/Linux
rm -rf node_modules/.vite
# Windows 命令行
rmdir /s /q node_modules\.vite
# Windows PowerShell
Remove-Item -Recurse -Force node_modules\.vite

2. 检查并修复文件夹权限 #

Windows下权限限制可能导致Vite无法创建临时文件：

• 右键项目文件夹，选择「属性」→「安全」，确保当前用户拥有「完全控制」权限
• 以管理员身份打开终端，再执行npm run dev

3. 自定义Vite缓存目录 #

在vite.config.js中指定新的缓存路径，避开系统权限或路径解析问题：

export default {
  cacheDir: './.vite-custom-cache'
}

保存配置后删除原缓存目录，重启开发服务器。

4. 切换Vite版本 #

当前Vite 4.4.9可能存在特定版本bug，尝试切换版本：

# 降级至4.4.8
npm install vite@4.4.8 --save-dev
# 或升级至最新稳定版
npm install vite@latest --save-dev

重装后重启开发服务器验证。

5. 排查杀毒软件拦截 #

Windows Defender或第三方杀毒软件可能拦截Vite创建临时文件，暂时关闭实时保护后再启动开发服务器测试。

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