问题原因 #

启动时提示找不到turbo-windows-64/bin/turbo.exe，大概率是安装Turborepo时使用了--no-optional参数，导致平台专属的二进制依赖未被安装。

解决步骤 #

• 彻底重装Turborepo，确保可选依赖正常安装

  1. 先卸载现有Turborepo：

     npm uninstall turbo
     

  2. 清理npm缓存，避免残留异常文件：

     npm cache clean --force
     

  3. 重新安装指定版本的Turborepo，不添加--no-optional参数：

     npm install turbo@^2.5.3 --save-dev
     

• 检查npm全局配置是否禁用了可选依赖

  1. 查看当前可选依赖配置：

     npm config get optional
     

  2. 如果返回false，执行以下命令启用可选依赖：

     npm config set optional true
     

     执行完成后再重新执行上面的重装步骤。

• 手动补全二进制文件（自动安装失败时备用）

  1. 找到对应版本的Turborepo发布包，提取turbo-windows-64.zip压缩包
  2. 解压后将turbo.exe文件复制到项目的node_modules/turbo-windows-64/bin/路径下（路径不存在则手动创建）

验证修复结果 #

执行以下命令检查Turborepo是否正常可用：

npx turbo --version

如果能正常输出版本号，再运行npm run start:dev即可启动项目。

内容的提问来源于stack exchange，提问作者Jovany George Shafik