安装

使用以下方式快速开始使用 Turborepo

终端
pnpm dlx create-turbo@latest

起始仓库将包含

  • 两个可部署的应用程序
  • 三个共享库,供单体仓库的其他部分使用

有关起始仓库的更多详细信息,请访问 GitHub 上基本起始仓库的 README。您也可以使用一个更符合您工具兴趣的示例

安装 turbo

turbo 可以全局安装,也可以安装在您的仓库中。我们强烈建议两种方式都安装,以便您可以利用快速便捷的工作流,并为仓库中的所有开发人员提供一个稳定的 turbo 版本。

全局安装

全局安装 turbo 为您的本地工作流带来了灵活性和速度。

终端
pnpm add turbo --global

一旦全局安装,您就可以通过 turbo 从终端运行您的脚本,快速运行一次性命令以在您的仓库中使用。例如:

  • turbo build:根据仓库的依赖图运行 build 脚本
  • turbo build --filter=docs --dry:快速打印 docs 包的 build 任务概述(不运行它)
  • turbo generate:运行生成器以向您的仓库添加新代码
  • cd apps/docs && turbo build:在 docs 包及其依赖项中运行 build 脚本。更多信息请访问自动包范围划分部分

须知: 

turboturbo run 的别名。例如,turbo buildturbo run build 都会运行您的 build 任务。

避免多次全局安装

如果您之前已经全局安装了 turbo,请确保使用与您现有安装相同的包管理器,以避免意外行为。您可以使用 turbo bin 快速检查您之前使用的包管理器。

在 CI 中使用全局 turbo

您还可以在创建 CI 管道时利用全局 turbo。有关更多信息,请访问构建 CI 指南。

仓库安装

当与仓库中的其他开发人员协作时,最好固定依赖项的版本。您可以通过将 turbo 作为 devDependency 添加到仓库的根目录来实现这一点:

终端
pnpm add turbo --save-dev --ignore-workspace-root-check

您可以继续使用全局安装的 turbo 来运行命令。如果您的仓库中存在本地版本,全局 turbo 将会优先使用本地版本。

这让您能够充分利用两种安装方式:在终端中轻松运行命令,同时为仓库中的所有开发人员保持一个固定版本以实现一致的使用。