You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

在VS Code终端执行npm start启动React项目时出错求助

React项目npm start启动失败的解决办法

从错误截图可知,启动失败的核心原因是3000端口被占用,结合你提供的package.json配置,给你以下几种解决思路:

1. 释放3000端口

Windows系统操作:

  • 打开命令提示符,输入netstat -ano | findstr :3000,找到输出里的进程ID(PID)
  • 输入taskkill /PID <找到的PID> /F,强制终止占用端口的进程

macOS/Linux系统操作:

  • 在终端直接执行lsof -ti:3000 | xargs kill -9,一键杀死占用3000端口的所有进程

2. 重置项目依赖

如果端口释放后还是报错,可能是依赖安装不完整:

  • 删除项目根目录下的node_modules文件夹和package-lock.json文件
  • 执行npm install重新安装所有依赖
  • 再次运行npm start

3. 更换启动端口

不想折腾端口的话,直接改项目启动端口:
修改package.json里的scripts字段:

"scripts": {
  "start": "set PORT=3001 && react-scripts start", // Windows用这个
  // macOS/Linux替换成:"start": "PORT=3001 react-scripts start",
  "build": "react-scripts build",
  "test": "react-scripts test",
  "eject": "react-scripts eject"
}

保存后执行npm start,项目会在3001端口启动

额外检查

你的package.json里react-scripts版本是5.0.1,和React 18兼容。如果以上方法都没用,试试更新react-scripts:

npm install react-scripts@latest

内容的提问来源于stack exchange,提问作者ŞehzadeEren

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.23 06:18:20