下载Next.js网站模板后执行npm run dev本地运行报错求助

报错原因 #

从报错信息来看，核心问题是找不到next/dist/build/webpack/loaders/next-swc-loader模块，多半是这几种情况：

• 依赖安装不完整，部分包缺失
• Next.js版本与模板要求的版本不兼容
• 缓存文件干扰导致依赖加载异常

解决步骤 #

• 先清理本地依赖包和缓存文件：

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

• 重新安装依赖：

  npm install
  

• 如果还是报错，查看模板package.json里指定的Next.js版本，手动安装对应版本：

  npm install next@<模板指定的版本号>
  

• 最后重启开发服务：

  npm run dev
  

额外提示 #

要是以上方法都无效，可以尝试把Node.js更新到稳定版本（推荐16.x或18.x），部分旧版Node.js和新版Next.js存在兼容性问题。

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