Biome

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

Good to know:

This guide assumes you're using create-turbo or a repository with a similar structure.

与 Turborepo 一起使用 Biome

Biome 是与 Turborepo 一起使用的工具中一个罕见的例外，因为它非常快速。因此，我们建议使用根任务，而不是在每个包中创建单独的脚本。

缓存行为

在项目根目录使用 Biome 将导致当你升级 Biome 版本或更改配置时，所有任务的缓存将失效。如果你在这些情况下更喜欢更高的缓存命中率而不是更少的配置，你仍然可以像我们指南中的其他建议一样在单独的脚本中使用 Biome。

首先，遵循安装文档在你的仓库中设置 Biome。然后，你将能够创建一个脚本，在仓库的根目录中使用 Biome：

./package.json

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

实际上，Biome 不太可能成为你仓库迭代速度的瓶颈。因此，我们可以通过在根任务中使用 Biome 来减少仓库中需要管理的配置。

如果你认为在你的仓库中将 Biome 分解为包中的任务可能会更快，你可以自由选择这样做。我们鼓励你尝试找出最适合你的用例的方法。

要创建根任务，请向 Turborepo 注册脚本：

./turbo.json

{
  "tasks": {
    "//#format-and-lint": {},
    "//#format-and-lint:fix": {
      "cache": false
    }
  }
}

现在，你将能够使用 turbo run format-and-lint 和 turbo run format-and-lint:fix 运行这些脚本。