返回博客

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，或全局安装 NEW 并运行 set-default-outputs 代码模组。

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

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

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。

终端
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 要缓存的内容。

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 成为您首选的构建工具。