克隆GitHub的React/Next.js项目执行npm start时提示next未识别错误

问题根因 #

报错核心是克隆项目后未安装项目依赖，next是Next.js框架的专属命令，既没有在本地项目安装、全局环境也没有安装的情况下，系统无法识别该命令，同时npm也明确给出了node_modules missing的警告提示。

解决步骤 #

• 第一步：进入项目根目录（包含package.json文件的目录），执行npm install安装所有项目依赖，所有package.json中声明的依赖包会自动下载到本地node_modules目录。
• 第二步：依赖安装完成后，根据场景执行对应启动命令即可：
  • 开发环境调试运行：执行npm run dev
  • 生产环境部署运行：先执行npm run build完成项目打包，再执行npm start启动服务

异常排查 #

如果执行完npm install仍报错，可按以下顺序排查：

• 检查Next.js版本和Node版本兼容性：你当前本地Node版本为v12.16.1，仅支持Next.js 12及更低版本，如果项目使用的是Next.js 13及以上版本，需要将Node版本升级到v16.8.0及以上。
• 版本适配后仍有问题可全局安装Next.js临时解决，执行命令npm install -g next即可，不过更推荐优先使用项目本地安装的依赖版本，避免不同项目的版本冲突。

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