使用Vite创建React+TypeScript项目时遇MODULE_NOT_FOUND错误求助

可能原因及对应修复步骤 #

1. 路径空格导致解析失败 #

Windows系统下，项目路径包含空格（如Au Personal Folder）会干扰Node.js的模块解析逻辑：

• 将项目迁移到无空格、无特殊字符的路径下，例如D:\projects\my-vite-react-ts
• 重新进入项目目录，执行npm install，再尝试npm run dev

2. 本地依赖安装异常 #

npm install可能出现静默失败，导致Vite未被正确安装：

• 删除项目根目录下的node_modules文件夹和package-lock.json文件
• 重新执行npm install，等待依赖完全安装完成
• 用npx vite dev替代npm run dev，直接调用本地安装的Vite包

3. 全局Vite缓存冲突 #

全局安装的Vite可能存在缓存或版本冲突：

• 执行npm uninstall -g vite卸载全局Vite
• 清理npm缓存：npm cache clean --force
• 重新通过npm create vite@latest创建项目，全程使用本地依赖执行命令

4. 检查package.json配置 #

确认项目package.json的scripts字段中dev命令是否正确：

"scripts": {
  "dev": "vite",
  "build": "tsc && vite build",
  "preview": "vite preview"
}

若命令被错误修改，恢复为默认的"dev": "vite"即可

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