Turborepo 2.2

姓名

Tom Knickman

X

@tknickman

姓名

Anthony Shew

X

@anthonysheww

姓名

Chris Olszewski

姓名

Nicholas Yang

X

@nicholaslyang

姓名

Dimitri Mitropoulos

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

• 仓库查询 实验性功能：以前所未有的方式探索您的仓库，使用 turbo query
• 改进的缓存安全性：轻松诊断和修复缺失的环境变量依赖项以及不正确的缓存配置
• 受影响软件包的零配置比较：在 GitHub 工作流程中自动定位已更改的软件包

立即运行 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 任务的 受影响软件包 的名称和路径。

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

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

query {
  package(name: "cli") {
    directDependencies {
      name
    }
  }
}

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

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 时引入自动比较——使常见的用例更加智能。

• 对于响应 拉取请求 而运行的工作流程，比较的基础自动设置为拉取请求的基础。这确保了 turbo 在确定受影响的软件包时会考虑拉取请求中更改的任何文件。
• 对于响应 推送 而运行的工作流程，比较的基础自动设置为您最新推送之前的提交。

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

社区

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

• 2.62 万+ GitHub 星星
• 每周 320 万+ NPM 下载量
• 通过 Vercel 上的远程缓存，节省了 477 年的计算时间

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

查看完整的更新日志。

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