使用npm create vite创建React项目后执行npm run dev提示vite未识别

问题描述 #

执行npm create vite@latest my-react-app --template react生成React项目后，运行npm run dev时出现错误：

'vite' is not recognized as an internal or external command, operable program or batch file.

项目已生成包含vite@5.0.0依赖的package.json及相关源码文件。

解决方案 #

• 第一步：安装项目依赖
  项目生成后并未自动安装依赖，需手动执行：

  npm install
  

  安装完成后再次运行npm run dev即可启动开发服务器。

• 若安装后仍报错，尝试以下操作

  1. 删除依赖目录和锁文件后重新安装
     Windows系统执行：

     Remove-Item -Recurse -Force node_modules, package-lock.json
     npm install
     

     类Unix系统执行：

     rm -rf node_modules package-lock.json
     npm install
     

  2. 清理npm缓存
     缓存损坏可能导致依赖安装不完整：

     npm cache clean --force
     npm install
     

  3. 检查Node.js版本
     Vite 5.0.0要求Node.js版本≥18.0.0，执行node -v查看版本，若版本过低需升级Node.js。
  4. 临时用npx调用vite
     若以上方法都无效，可直接通过npx执行vite命令：

     npx vite
     

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