创建React应用后无法启动start脚本的问题求助

排查步骤与解决方案 #

1. 确认运行命令正确 #

确保你在项目根目录下执行的是正确的启动命令：

npm start
# 或使用yarn（如果用yarn初始化项目）
yarn start

不要直接输入start，这会被系统当作独立命令而非npm脚本。

2. 重新安装依赖 #

可能是依赖安装不完整或损坏，执行以下步骤修复：

# 删除现有依赖包和锁文件
rm -rf node_modules package-lock.json
# 重新安装所有依赖
npm install

安装完成后再次尝试启动应用。

3. 检查Node.js与npm版本 #

Create React App要求Node.js >=14.0.0、npm >=5.6，运行以下命令查看当前版本：

node -v
npm -v

如果版本过低，推荐用nvm管理Node版本（避免Ubuntu系统自带版本过旧的问题）：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重启终端后安装LTS版本
nvm install --lts
nvm use --lts

4. 排查端口占用问题 #

服务器短暂启动后无法访问，大概率是3000端口被占用：

• 查看占用3000端口的进程：

  lsof -i :3000
  

• 杀掉对应进程（替换<PID>为查到的进程ID）：

  kill -9 <PID>
  

• 或直接指定其他端口启动：

  PORT=3001 npm start
  

5. 移除可能冲突的工具 #

你安装过gulp，可能存在配置冲突。暂时移除gulp相关依赖和配置文件（如gulpfile.js），再尝试启动应用，确认是否是冲突导致的问题。

6. 检查package.json位置与完整性 #

确保你在包含package.json的项目根目录下执行命令，同时确认scripts字段没有语法错误（你的配置看起来是正确的，但可以重新复制粘贴确保没有隐形字符）。

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