从GitHub下载的React/Next项目启动失败，报错next: command not found

核心原因 #

项目本地依赖未正确安装，导致无法调用本地的next命令；直接执行next start会尝试调用全局next，但你未全局安装且本地依赖缺失。

分步解决方案 #

1. 清理并重新安装依赖 #

先删除残留的依赖文件，确保重新安装的依赖完整：

rm -rf node_modules package-lock.json
npm install --legacy-peer-deps

2. 用npx调用本地next命令 #

如果npm start仍报错，直接用npx执行项目本地的next：

npx next start

或者修改项目package.json中的start脚本：

"start": "npx next start"

修改后再执行npm start即可。

3. 确认并补装next依赖 #

检查项目package.json的dependencies字段，若没有next包，手动安装：

npm install next --legacy-peer-deps

4. 匹配项目要求的Node.js版本 #

查看项目package.json的engines字段（比如可能要求Node.js 16.x），用版本管理工具切换对应版本（以nvm为例）：

nvm install 16
nvm use 16

切换后重新执行依赖安装和启动命令。

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