单包工作区
虽然 Turborepo 在 多包工作区 (通常称为 monorepos) 中非常有效,但它也可以用于加速单包工作区。
Turborepo 最重要的功能在单包工作区中也有效,包括本地和远程缓存以及任务并行化。不适用的功能是在单包上下文中没有意义的功能,例如包任务 (app#build
)。
须知:
单包工作区的示例包括 npx create-next-app
或 npm create vite
的输出。
安装
将 turbo
安装到您的应用程序中
使用全局 turbo
运行 package.json
脚本(可选)
为了获得更快的开发者工作流程,您也可以全局安装 turbo
,并直接从命令行运行命令。
安装完成后,您可以运行 turbo build
,Turborepo 将从 package.json
运行您的 build
脚本。再次运行 turbo build
将命中缓存。
此时,turbo
没有提供太多价值,因为您可能只会在代码更改时重新构建应用程序,并且当您的代码更改时,turbo
将错过缓存。通过两个简单的步骤,您可以从 turbo
中获得更多。
使用一个命令运行多个脚本
在许多仓库中,都有设置任务或预构建步骤要运行。这些任务通常一次运行一个 - 但您可以使用 turbo
轻松地将它们变成一个脚本。
例如,假设您有一个项目,每次开始工作时,我们都必须设置开发环境。您需要
- 启动数据库的 Docker 容器。
- 将数据库模式推送到数据库。
- 使用数据填充数据库。
- 启动开发服务器。
您可以使用 Turborepo 将这些任务安排到一个命令中。首先,在您的 package.json
中创建脚本
然后,在 turbo.json
中创建任务以按顺序运行这些脚本
上面任务中的 dependsOn
数组为任务创建顺序。当您运行 turbo dev
时,将首先运行 db:up
,然后是 db:push
,然后是 db:seed
的脚本。
并行化任务
使用 turbo
并行化任务可以通过同时运行所有任务(在可以的情况下)来加速任务。例如,您可以同时运行 ESLint、TypeScript 和 Prettier 检查。给定如下脚本
您可以创建如下配置
然后,要同时运行所有任务
使用输入优化任务
由于 Turborepo 会将单包工作区视为一个包,因此它可以帮助优化任务的输入,以确保不相关的更改不会导致缓存未命中。
例如,可以使用仅包含 TypeScript 文件的输入来配置使用 tsc --noEmit
检查类型的脚本