Turborepo logo
构建你的仓库

了解你的仓库

Turborepo 包含用于理解你的仓库结构的工具，可以帮助你使用和优化你的代码库。

turbo ls

要列出你的包，你可以运行 turbo ls。这将显示你的仓库中的包以及它们的位置。

终端
> turbo ls
 
  @repo/eslint-config packages/eslint-config
  @repo/typescript-config packages/typescript-config
  @repo/ui packages/ui
  docs apps/docs
  web apps/web

你可以像 run 一样，应用过滤器到 ls

终端
> turbo ls --filter ...ui
3 packages (pnpm9)
 
  @repo/ui packages/ui
  docs apps/docs
  web apps/web

turbo run

要确定哪些任务可以在你的 monorepo 中运行，只需在不带任何任务的情况下调用 turbo run。你将获得一个任务列表以及定义它们的包。

终端
> turbo run
No tasks provided, here are some potential ones
 
  lint
    @repo/ui, docs, web
  build
    docs, web
  dev
    docs, web
  start
    docs, web
  generate:component
    @repo/ui

turbo query

如果你希望深入了解你的仓库结构，自 2.2.0 起，Turborepo 通过 turbo query 提供了一个 GraphQL 接口。你可以执行查询，例如查找所有具有 test 任务的包

终端
> turbo query "query { packages(filter: { has: { field: TASK_NAME, value: \"build\"}}) { items { name } } }"
{
  "data": {
    "packages": {
      "items": [
        {
          "name": "//"
        },
        {
          "name": "docs"
        },
        {
          "name": "web"
        }
      ]
    }
  }
}

这有助于诊断你的包或任务依赖关系图中的潜在问题。例如，假设你的构建中出现了很多缓存未命中。这可能是因为有一个包一直在更改，并且被导入到你的整个代码库中。

为此，我们可以运行一个查询来查找在你的 monorepo 中被直接导入超过 10 次的包

终端
> turbo query "query { packages(filter: { greaterThan: { field: DIRECT_DEPENDENT_COUNT, value: 10 } }) { items { name } } }"
{
  "data": {
    "packages": {
      "items": [
        {
          "name": "utils"
        }
      ]
    }
  }
}

现在我们已经找到了这个包，我们可以尝试将其拆分成更小的包，以便小的更改不会使整个依赖关系图失效。

或者，假设你正在使用我们新的 --affected 标志，但你仍然运行了比你想要的更多的任务。使用 turbo query，你可以找到所有包以及它们失效的原因

终端
> turbo query "query { affectedPackages(base: \"HEAD^\", head: \"HEAD\") { items { reason {  __typename } } } }"
{
  "data": {
    "affectedPackages": {
      "items": [
        {
          "name": "utils",
          "reason": {
            "__typename": "FileChanged"
          }
        },
        {
          "name": "web",
          "reason": {
            "__typename": "DependencyChanged"
          }
        },
        {
          "name": "docs",
          "reason": {
            "__typename": "DependencyChanged"
          }
        },
        {
          "name": "cli",
          "reason": {
            "__typename": "DependencyChanged"
          }
        },
      ]
    }
  }
}

上一篇

构建 CI

下一篇

升级

小时

总计算节省
开始使用
远程缓存 →

本页内容