返回博客

Turborepo 2.2

2024 年 10 月 18 日，星期五
Tom Knickman
姓名
Tom Knickman
X
@tknickman
Anthony Shew
姓名
Anthony Shew
X
@anthonysheww
Chris Olszewski
姓名
Chris Olszewski
Nicholas Yang
姓名
Nicholas Yang
X
@nicholaslyang
Dimitri Mitropoulos
姓名
Dimitri Mitropoulos

Turborepo 2.2 带来了新的仓库查询命令，以及其他改进，包括：

立即运行 npx @turbo/codemod migrate 进行更新，或使用 npx create-turbo@latest 开始使用。

查询您的仓库 实验性

在 Turborepo 2.2 中，我们引入了 turbo query——一个新的命令，允许针对 Turborepo 的仓库数据运行 GraphQL 查询。Turborepo 会计算有关您仓库的大量数据，以便以最大效率执行您的任务。这包括您的软件包依赖关系图、更改的软件包、任务依赖项、任务的日志输出等。这些数据对于编写脚本、重构、确定在 CI 中运行什么以及发现代码库的其他见解非常有用。

要开始使用，请运行 turbo query 以打开 GraphiQL——一个用于编写 GraphQL 查询的本地 IDE，支持交互式模式探索、文档和发送查询。

您也可以直接将查询作为字符串或文件路径传递

终端
turbo query "query { package(name: \"web\") { name } }"
turbo query query.gql

示例

获取所有具有 test 任务的 受影响软件包 的名称和路径。

affected-packages.gql
{
  affectedPackages(
    base: "main"
    head: "HEAD"
    filter: { has: { field: TASK_NAME, value: "test" } }
  ) {
    items {
      name
      path
    }
  }
}

获取特定软件包及其直接依赖项。

direct-dependencies.gql
query {
  package(name: "cli") {
    directDependencies {
      name
    }
  }
}

查找所有具有 10 个以上直接依赖项的软件包。

filter.gql
query {
  packages(
    filter: { greaterThan: { field: DIRECT_DEPENDENT_COUNT, value: 10 } }
  ) {
    name
  }
}

Turborepo 过去添加了用于结构化数据的 API，例如 运行摘要、试运行 和 ls。但是，这些 API 有一些限制。首先，它们以单次运行为中心，而不是一般的仓库信息。其次，随着我们添加更多字段，输出很快变得非常大。我们需要一种以与运行无关的方式查询仓库数据的方法，并使返回的数据更加可定制。

我们要感谢 @maschwenk、@rafaeltab 和 @weyert 对此功能的早期反馈。

要了解更多信息，请访问文档，并在 turbo query RFC 上留下对这个新的实验性命令的反馈。

改进的缓存安全性

缓存任务是 Turborepo 最强大的功能之一，它通过仅重新运行已更改的内容来加速构建和其他任务。在 Turborepo 2.2 中，我们将发布一些改进，以帮助配置缓存输入和输出，并在出现不正确的情况时发出警告。

平台环境变量

在部署您的应用程序时，您可能已经在生产环境中配置了环境变量。现在，对于支持的平台，Turborepo 将自动检查这些环境变量与您的 turbo.json 配置，以确保您已正确考虑了它们，并会警告您任何丢失的环境变量。

任何平台都可以通过在构建环境中实现 TURBO_PLATFORM_ENV 环境变量来支持此功能。

今天支持 Vercel，我们将随着更多平台的可用性更新文档。

了解有关 平台环境变量的更多信息。

空缓存配置的警告

在运行任务时，如果任务配置为缓存空目录，Turborepo 现在会发出警告。这可能是一个常见的错误，并可能导致意外的构建中断。默认情况下，在 2.2 中启用此功能。

了解有关 配置输出的更多信息。

对 eslint-config-turbo 的改进

Turborepo 会自动为 通用框架 的 env 键添加前缀通配符。如果您使用的是支持的框架之一，则无需指定以该框架前缀开头的环境变量。

现在在 Turborepo 2.2 中，eslint-config-turbo 也支持此功能，确保插件的警告准确且可操作。

了解有关 eslint-config-turbo的更多信息。

使用 --affected 进行零配置比较

在 Turborepo 2.1 中，我们发布了 --affected 标志，该标志可与 turbo run 和 turbo ls 一起使用，以自动定位更改的软件包。在 2.2 中，我们更进一步，通过在 GitHub 工作流程中运行 --affected 时引入自动比较，使常见的用例更加智能。

了解有关 --affected 的更多信息。

社区

自从发布 Turborepo 2.1 以来，我们看到了令人难以置信的采用率和社区增长

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

查看完整的 更新日志。

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