使用npx create-react-app创建项目后执行npm start报错如何解决？
2026-10-10
npm start启动React项目失败排查方案
- 重新安装依赖
删除项目根目录下的node_modules文件夹、package-lock.json文件，依次执行以下命令：
安装完成后重试npm cache clean --force npm installnpm start看是否恢复正常。 - 测试端口占用问题
create-react-app默认使用3000端口启动，端口被其他应用占用会触发启动失败，可手动指定其他端口测试启动：- Windows环境执行：
set PORT=3001 && npm start - Mac/Linux环境执行：
PORT=3001 npm start
若指定端口后可正常启动，说明原3000端口被占用，可终止占用3000端口的进程，或每次启动时自定义端口即可。
- Windows环境执行：
- 检查Node.js版本兼容性
最新版create-react-app要求Node.js版本不低于14.0.0，执行node -v查看本地Node版本，若版本过低请升级至Node.js官方LTS版本后重试。 - 检查项目路径合法性
项目存放的完整路径如果包含中文、空格、特殊符号，会导致编译流程异常，将项目移动到纯英文无特殊字符的路径下重试启动即可。 - 清理旧版本脚手架冲突
本地如果之前全局安装过旧版create-react-app，会和npx调用的最新版本产生冲突，先执行npm uninstall -g create-react-app卸载全局包，再重新创建项目测试。
内容的提问来源于stack exchange，提问作者YEETter 23414323424
相关产品推荐
相关产品推荐
