Laravel 10执行npm run dev报错sh: vite: command not found求助

算力阿峰

2026-7-8

解决Laravel 10中npm run dev报sh: vite: command not found的问题

针对M1芯片MacBook的情况，尝试以下步骤排查：

强制重新安装依赖
先清除旧依赖和缓存，避免安装残留问题：
```
rm -rf node_modules package-lock.json
npm cache clean --force
npm install
```
若仍无效，右键打开终端，勾选「使用Rosetta打开」后重新执行上述命令，解决M1架构的兼容问题。
直接调用本地vite执行
跳过npm脚本，直接运行项目本地的vite：
```
./node_modules/.bin/vite
```
如果此命令能正常启动，说明系统PATH未包含项目本地的node_modules/.bin路径。可以将该路径临时加入PATH：
```
export PATH="./node_modules/.bin:$PATH"
npm run dev
```
检查Node.js版本兼容性
Laravel 10要求Node.js版本为16.x或18.x，版本不匹配可能导致依赖安装异常。用nvm切换到兼容版本：
```
nvm install 18
nvm use 18
rm -rf node_modules package-lock.json
npm install
```
全局安装vite临时验证
若上述方法无效，可尝试全局安装vite测试：
```
npm install -g vite
```
再执行npm run dev，若能运行则说明本地依赖安装存在异常，需重新检查项目的package.json和npm配置。