Biome

Biome 是一个快速的 JavaScript、TypeScript、JSX 和 JSON 格式化工具,可以节省 CI 和开发人员的时间。

须知: 

本指南假设您正在使用 create-turbo 或具有类似结构的仓库。

在 Turborepo 中使用 Biome

Biome 是大多数与 Turborepo 一起使用的工具的一个罕见例外,因为它 **极其快速**。因此,我们建议使用 Root Task,而不是在每个包中创建单独的脚本。

缓存行为

在项目根目录使用 Biome 会导致在升级 Biome 版本或更改配置时,所有任务都会出现缓存未命中。如果您宁愿在这些情况下获得更高的缓存命中率而不是更少的配置,您仍然可以像我们指南中的其他建议一样,在单独的脚本中使用 Biome。

初始化 Biome

首先,遵循安装文档在您的仓库中设置 Biome。然后,您就可以创建一个脚本在您的仓库根目录中使用 Biome 了。

./package.json
{
  "scripts": {
    "format-and-lint": "biome check .",
    "format-and-lint:fix": "biome check . --write"
  }
}

创建根任务

实际上,Biome 不太可能成为您仓库迭代速度的瓶颈。因此,通过在 Root Task 中使用 Biome,我们可以减少需要管理的配置。

如果您认为 Biome 在您拆分到各个包中的任务中会更快,您可以自由这样做。我们鼓励您尝试最适合您用例的方法。

要创建 Root Task,请将脚本注册到 Turborepo。

Turborepo logo
./turbo.json
{
  "tasks": {
    "//#format-and-lint": {},
    "//#format-and-lint:fix": {
      "cache": false
    }
  }
}

您现在可以使用 turbo run format-and-lintturbo run format-and-lint:fix 来运行这些脚本。