返回博客

Turborepo 1.7

2023 年 1 月 11 日，星期三
Greg Soltis
姓名
Greg Soltis
X
@gsoltis
Nathan Hammond
姓名
Nathan Hammond
Tom Knickman
姓名
Tom Knickman
X
@tknickman
Anthony Shew
姓名
Anthony Shew
X
@anthonysheww
Jared Palmer
姓名
Jared Palmer
X
@jaredpalmer
Mehul Kar
姓名
Mehul Kar
X
@mehulkar
Chris Olszewski
姓名
Chris Olszewski
Nicholas Yang
姓名
Nicholas Yang
X
@nicholaslyang

Turborepo 1.7 专注于通过更清晰地展示您的任务来改善开发者体验

立即运行 npm install turbo@latest 进行更新，或者全局安装 新功能 并运行 set-default-outputs 代码修改。

自信地安排您的长时间运行任务

为了避免可能导致任务永远不会运行的错误配置，您现在可以使用 persistent: true 配置选项 告诉 Turborepo 关于不会自行退出的任务（如 dev 脚本）。当在此任务上设置此配置时，Turborepo 将确保没有其他任务可以依赖此任务。这对于 dev 任务或带有 --watch 标志的测试运行器非常有用。

Turborepo logo
turbo.json
{
	"pipeline": {
		"dev": {
+			"persistent": true
		}
	}
}

以前，如果 Task B 依赖于持久性 Task A，则 Task B 永远不会执行，因为 Task A 永远不会退出。通过将 Task A 声明为 persistent，Turborepo 将防止发生此错误情况。

在此版本之前，我们一直建议对持久性任务使用 turbo run <task> --parallel。使用 --parallel，turbo 将忽略您的依赖关系图并一次执行所有任务。

虽然 --parallel 确实提供了一个有用的应急方案，但这意味着用户必须告诉 Turborepo 如何 运行他们的任务，而不是声明任务 是什么。

与其抛弃整个拓扑依赖关系图，不如让 Turborepo 保留您的依赖关系图，同时保证您不依赖于一个不会通过 persistent: true 退出的进程，这要精确得多。

全局 turbo

全局安装 turbo 后，您现在可以从项目中的任何位置运行 Turborepo 任务。要做到这一点，请使用

终端
npm install turbo --global

turbo 现在可以在任何项目中使用。要查找您的本地 turbo 版本，turbo 将执行几个步骤，始终从您当前目录向上查找

  1. 查找最近的 turbo.json。
  2. 如果未找到，则查找第一个具有 workspaces 属性的 package.json。
  3. 如果未找到，则查找第一个 package.json。

您的全局安装的 turbo 版本仅在本地安装的 turbo 版本不存在或找不到时才会使用。

turbo-inference

turbo --version 和 turbo bin 将分别显示将执行您的任务的 turbo 副本的版本和二进制位置。此外，使用 -vv 或 --verbosity=2 运行时，将始终显示正在使用您的本地还是全局 turbo。

终端
turbo --version --verbosity=2
2023-01-11T10:49:04.042-0500 [DEBUG] turborepo_lib::shim: No local turbo binary found at: /Users/knickman/Developer/vercel/my-awesome-monorepo/node_modules/.bin/turbo
2023-01-11T10:49:04.042-0500 [DEBUG] turborepo_lib::shim: Running command as global turbo
1.7.0

声明您的 outputs 以提高清晰度

以前，如果您没有为任务指定 outputs 键，Turborepo 将自动尝试缓存 dist/ 和 build/ 目录中的所有文件。

这对于特定框架的 build 任务效果很好，但是这种隐式行为无法很好地扩展，因为它适用于所有任务。我们发现，在许多使用 Turborepo 的开发者、团队、项目和代码库中，自动缓存 dist/ 和 build/ 目录的假设给用户带来了问题。

在 1.7 版本中，此行为已被删除，您现在需要显式告诉 turborepo 要缓存的内容。

Turborepo logo
turbo.json
{
  "pipeline": {
    "build": {
+     "outputs": ["dist/**", "build/**"]
    }
  }
}

如果您依赖于 1.7 以下版本的 Turborepo 中的默认缓存输出，您可以通过运行 @turbo/codemod set-default-outputs 代码修改来获得相同的行为

终端
npx @turbo/codemod set-default-outputs

另请注意，您将不再需要指定 outputs: []，因为不缓存任何内容现在是默认行为。代码修改还将从您的任务中删除此配置。

“仅错误”输出模式，用于更安静的日志

为了提高错误的可见性，社区成员 @dobesv 贡献了 一个仅显示错误而不是任务运行中的所有日志的解决方案。在调试管道时，可以使用 --output-logs=errors-only 来保持您的信噪比，以便您可以专注于确保管道成功运行。这可以作为 配置选项 或作为 CLI 标志 使用

终端
turbo build --output-logs=errors-only

社区

自从发布 Turborepo v1.6 并与 Turbopack 合并以来，我们看到了令人难以置信的采用率和社区增长

Turborepo 是我们所有贡献者（包括我们的核心团队）共同努力的成果。

感谢您持续的支持、反馈和协作，使 Turborepo 成为您的首选构建工具。