所有React项目执行npm start均报错，求助解决方案

1. 先获取完整报错信息 #

所有排查的核心前提是拿到完整的报错日志，包括错误代码、堆栈追踪、具体的错误描述。执行npm start时，把终端里的所有报错内容完整复制下来，这是定位问题的关键依据。

2. 检查端口占用情况 #

React默认使用3000端口，若被其他程序占用会直接启动失败：

• Windows：查看端口占用进程

  netstat -ano | findstr :3000
  

  找到对应PID后，打开任务管理器杀掉该进程；或临时修改启动端口：

  set PORT=3001 && react-scripts start
  

• macOS/Linux：查看并终止占用进程

  lsof -i :3000
  kill -9 <查到的PID>
  

  或临时修改端口：

  PORT=3001 react-scripts start
  

3. 排查npm权限与全局依赖问题 #

• 重新安装全局react-scripts依赖：

  npm install -g react-scripts
  

• 创建全新测试项目验证问题范围：

  npx create-react-app test-demo
  cd test-demo
  npm start
  

  如果全新项目能正常启动，说明旧项目存在配置或依赖冲突；若仍报错，问题出在系统环境层面。

4. 切换Node LTS版本 #

最新版Node可能存在兼容性问题，建议切换到长期支持（LTS）版本：

• 安装Node版本管理器nvm（Windows用nvm-windows），执行以下命令切换：

  nvm install --lts
  nvm use --lts
  

  之后重新删除项目的node_modules和package-lock.json，执行npm install再尝试启动。

5. 清理代理与环境变量检查 #

• 检查并清除npm代理设置：

  npm config get proxy
  npm config get https-proxy
  # 若输出非空，执行清除命令
  npm config delete proxy
  npm config delete https-proxy
  

• 验证Node/npm环境变量：执行node -v和npm -v，确认能正常输出版本号，说明路径配置无误。

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