如何解决Vite启动时ENOENT：找不到带时间戳的配置文件错误？

核心问题分析 #

Vite尝试读取自动生成的带时间戳临时配置文件而非正常的vite.config.js，且新建项目也出现相同问题，说明问题大概率出在系统环境、文件权限或第三方工具干扰上，而非项目代码本身。

解决方案步骤 #

1. 排查第三方工具干扰

   • 临时关闭Windows Defender实时保护或其他杀毒软件，这类软件可能拦截Vite创建/读取临时文件的操作
   • 暂停OneDrive、GitHub Desktop等文件同步工具的自动同步，避免文件被后台锁定或修改

2. 彻底清理缓存文件

   • 删除项目根目录下的.vite文件夹，以及node_modules和package-lock.json
   • 清空npm全局缓存：

     npm cache clean --force
     

   • 清理Windows临时文件：按Win+R输入%temp%，删除所有含vite或timestamp字样的临时文件

3. 指定配置文件启动
   启动开发服务器时手动指定配置文件路径，强制Vite读取正常的配置文件：

   npm run dev -- --config vite.config.js
   

4. 更换包管理器尝试
   改用yarn或pnpm替代npm，避免npm锁文件或缓存逻辑导致的异常：

   # 卸载现有依赖
   rm -rf node_modules package-lock.json
   # 用pnpm安装并启动
   pnpm install
   pnpm dev
   

5. 修复文件权限与路径

   • 确保项目路径无特殊字符（空格、中文、特殊符号），尽量使用简短路径
   • 右键项目文件夹→属性→安全，确认当前用户拥有完全控制权限
   • 以管理员身份运行命令提示符，再执行启动命令

6. 重置Node.js环境

   • 卸载当前Node.js 18版本，重新下载稳定版（如18.19.0）并默认安装，避免自定义路径或选项
   • 执行npm config list检查全局配置，确保registry等核心配置正常（推荐使用官方源https://registry.npmjs.org/）

内容的提问来源于stack exchange，提问作者roberto berrendo eguino