克隆Next.js示例仓库后运行npm run dev提示“next: command not found”怎么办？

• 先安装本地项目依赖
  克隆仓库后，项目根目录下的node_modules文件夹和依赖包默认不存在，全局安装create-next-app只是创建项目的工具，和启动项目需要的本地next包无关。执行以下命令安装所有本地依赖：

npm install

• 检查package.json的scripts配置
  打开项目根目录的package.json，确认scripts里的dev命令是否为：

"scripts": {
  "dev": "next dev"
}

如果存在路径错误或拼写问题，修正后再尝试启动。也可以直接指定本地next命令的路径来规避环境变量问题：

"scripts": {
  "dev": "./node_modules/.bin/next dev"
}

• 清理缓存并重新安装依赖
  如果依赖安装过程中出现损坏，执行以下操作重置：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

• 直接用npx调用本地next命令
  npx会自动查找项目本地node_modules中的可执行命令，无需依赖环境变量，直接执行：

npx next dev

• 验证Node.js和npm版本兼容性
  Next.js对Node.js版本有最低要求（如v13+，最新版要求v18.17+），执行以下命令查看当前版本：

node -v
npm -v

版本不兼容时，建议用nvm（Node版本管理器）升级或切换到符合要求的Node.js版本。

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