安装
使用以下方式快速开始使用 Turborepo
起始仓库将包含
- 两个可部署的应用程序
- 三个共享库,供单体仓库的其他部分使用
有关起始仓库的更多详细信息,请访问 GitHub 上基本起始仓库的 README。您也可以使用一个更符合您工具兴趣的示例。
安装 turbo
turbo 可以全局安装,也可以安装在您的仓库中。我们强烈建议两种方式都安装,以便您可以利用快速便捷的工作流,并为仓库中的所有开发人员提供一个稳定的 turbo 版本。
全局安装
全局安装 turbo 为您的本地工作流带来了灵活性和速度。
一旦全局安装,您就可以通过 turbo 从终端运行您的脚本,快速运行一次性命令以在您的仓库中使用。例如:
turbo build:根据仓库的依赖图运行build脚本turbo build --filter=docs --dry:快速打印docs包的build任务概述(不运行它)turbo generate:运行生成器以向您的仓库添加新代码cd apps/docs && turbo build:在docs包及其依赖项中运行build脚本。更多信息请访问自动包范围划分部分。
须知:
turbo 是 turbo run 的别名。例如,turbo build 和 turbo run build 都会运行您的 build 任务。
避免多次全局安装
如果您之前已经全局安装了 turbo,请确保使用与您现有安装相同的包管理器,以避免意外行为。您可以使用 turbo bin 快速检查您之前使用的包管理器。
在 CI 中使用全局 turbo
您还可以在创建 CI 管道时利用全局 turbo。有关更多信息,请访问构建 CI 指南。
仓库安装
当与仓库中的其他开发人员协作时,最好固定依赖项的版本。您可以通过将 turbo 作为 devDependency 添加到仓库的根目录来实现这一点:
您可以继续使用全局安装的 turbo 来运行命令。如果您的仓库中存在本地版本,全局 turbo 将会优先使用本地版本。
这让您能够充分利用两种安装方式:在终端中轻松运行命令,同时为仓库中的所有开发人员保持一个固定版本以实现一致的使用。