新建NextJS项目执行yarn dev报错：无法找到模块‘C:\next\dist\bin\next’

问题原因 #

Windows系统默认没有sed、dirname、uname这类Unix环境下的命令，而Next.js的启动脚本依赖这些命令完成路径解析，导致脚本执行失败，最终出现模块找不到的错误。

解决方法 #

• 安装Git for Windows：
  下载安装Git for Windows（自带完整的Unix工具集），安装过程中确保勾选**"Add Git to your PATH"**选项（默认已勾选），安装完成后重启所有终端窗口，再执行yarn dev即可。
• 使用WSL2运行项目：
  启用Windows的WSL2功能，安装Linux发行版（如Ubuntu），在Linux环境下创建并运行Next.js项目，完全避免Windows和Unix工具的兼容性问题。
• 临时应急方案：
  跳过有问题的bin脚本，直接调用Next.js的Node模块启动项目，执行命令：

  node node_modules/next/dist/bin/next dev
  

• 检查环境变量：
  确认Node.js和Yarn的路径已正确添加到系统环境变量中，避免因环境变量异常导致的命令执行问题。

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