Node.js项目中Module not found: vite\bin\vite.js错误修复求助

原因排查与修复步骤 #

1. 重装依赖包 #

本地node_modules可能存在损坏或文件缺失，执行以下命令清理并重新安装：

# Windows系统
rd /s /q node_modules && del package-lock.json yarn.lock
npm install

# macOS/Linux系统
rm -rf node_modules package-lock.json yarn.lock
npm install

2. 验证依赖安装状态 #

执行命令确认Vite是否成功安装到项目中：

npm list vite

如果显示未安装，手动将Vite添加到开发依赖：

npm install vite --save-dev

3. 检查环境变量配置 #

确保node_modules\.bin目录被系统识别：

• Windows：打开系统环境变量设置，在用户PATH中添加%USERPROFILE%\AppData\Roaming\npm，也可直接尝试执行项目内的Vite命令：.\node_modules\.bin\vite测试是否能运行。
• macOS/Linux：检查~/.bashrc或~/.zshrc文件，确认是否包含export PATH="./node_modules/.bin:$PATH"，没有则添加后重启终端。

4. 清理npm缓存 #

缓存损坏可能导致依赖安装异常，执行以下命令清理缓存后重装：

npm cache clean --force
npm install

5. 排查模块格式冲突 #

项目中设置了"type": "module"，当前Vite 5.2.7版本兼容ES模块，若问题仍存在，可临时移除"type": "module"字段测试是否为格式冲突导致。

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