克隆Next.js仓库后运行npm run dev报错，如何启动应用？

问题根源 #

GitHub仓库不会包含node_modules目录（默认被.gitignore排除），你克隆项目后的新目录里缺少依赖包，导致next dev命令找不到可执行文件，启动失败。报错信息里的npm WARN Local package.json exists, but node_modules missing已经明确指出了问题所在。

修复步骤 #

• 先在项目根目录执行依赖安装命令：

  npm install
  

  该命令会根据package.json和package-lock.json文件，下载并安装所有项目必需的依赖包，自动生成node_modules目录。
• 依赖安装完成后，再启动开发服务器：

  npm run dev
  

  此时开发服务器即可正常启动。

补充说明 #

• 如果你使用yarn或pnpm包管理器，对应执行yarn install或pnpm install完成依赖安装，之后用yarn dev或pnpm dev启动项目即可。
• 确认你的Node.js版本符合项目要求（可查看package.json中的engines字段），版本不兼容也可能引发类似启动失败问题。

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