使用npm run dev启动React项目时出错，请求协助排查

1. 端口被占用（对应你遇到的报错） #

Vite默认使用5173端口，若该端口被其他程序占用，会触发EADDRINUSE错误，解决方式：

• 临时更换端口启动：运行 npm run dev -- --port 5174（可替换为任意未被占用的端口，比如3000）
• 彻底清理占用端口的进程：
  • Windows：打开CMD，执行 netstat -ano | findstr :5173 获取进程PID，再运行 taskkill /F /PID <查到的PID>
  • Mac/Linux：终端执行 lsof -ti:5173 | xargs kill -9

2. 依赖安装异常 #

如果npm install过程中断或依赖包损坏，执行以下步骤：

• 删除项目根目录下的node_modules文件夹和package-lock.json文件
• 重新运行 npm install
• 再次尝试启动项目：npm run dev

3. Node.js版本不兼容 #

Vite要求Node.js版本为v14.18+、v16+，版本过低会导致启动失败：

• 运行 node -v 查看当前版本
• 若版本不达标，升级Node.js（推荐用nvm管理多版本，避免全局冲突）

4. Vite版本兼容性问题 #

如果使用的最新版Vite存在bug，可降级到稳定版：

• 执行 npm install vite@^4.4.9（该版本为经过验证的稳定版）
• 重新启动项目

内容的提问来源于stack exchange，提问作者Ali Sajad Ahmadi