はじめる

インストール方法

Biomeをインストールする最も速い方法は、 npm またはお好みのパッケージマネージャーを使用することです。これにはNode.js v14.18以降が必要です。

Node.jsをインストールせずにBiomeを使用したい場合は、スタンドアロン実行形式としてCLIを利用できます。

Biomeをインストールするには、 package.json ファイルが含まれるディレクトリで次のコマンドを実行します。

1
npm install --save-dev --save-exact @biomejs/biome

1
pnpm add --save-dev --save-exact @biomejs/biome

1
bun add --dev --exact @biomejs/biome

1
deno add --dev npm:@biomejs/biome

1
yarn add --dev --exact @biomejs/biome

設定

プロジェクトごとに biome.json または biome.jsonc（設定ファイル）を作成することを推奨します。これにより、コマンドを実行するたびにCLIのオプションを繰り返し指定する必要がなくなり、エディタ上で同じ設定を適用できるようになります。もしBiomeのデフォルト設定に満足している場合は、新たに設定ファイルを作成する必要はありません。

biome.json ファイルを作成するには、プロジェクトのルートディレクトリで init コマンドを実行します：

1
npx @biomejs/biome init

1
pnpm exec biome init

1
bunx --bun biome init

1
deno run -A npm:@biomejs/biome init

1
yarn exec biome init

--jsonc オプションを渡すことで、 biome.jsonc ファイルを代わりに生成します。

init コマンドを実行すると、そのディレクトリに biome.json ファイルが新規作成されます：

1
{
2
  "$schema": "https://biomejs.dev/schemas/2.3.2/schema.json",
3
  "vcs": {
4
    "enabled": false,
5
    "clientKind": "git",
6
    "useIgnoreFile": false
7
  },
8
  "files": { "ignoreUnknown": false },
9
  "formatter": { "enabled": true, "indentStyle": "tab" },
10
  "linter": {
11
    "enabled": true,
12
    "rules": { "recommended": true }
13
  },
14
  "javascript": { "formatter": { "quoteStyle": "double" } },
15
  "assist": {
16
    "enabled": true,
17
    "actions": { "source": { "organizeImports": "on" } }
18
  }
19
}

linter.enabled: true はリンタを有効にし、 rules.recommended: true は推奨ルールを有効にします。これはデフォルトの設定と対応しています。

この設定では、formatter.enabled: false で明示的にフォーマットを無効化していないため、フォーマットは有効になっています。

使い方

Biome CLIには多くのコマンドとオプションが用意されているので、あなたが必要なものだけを使用できます。

format コマンドを --write オプションを指定し実行することで、ファイルやディレクトリをフォーマットできます。

1
npx @biomejs/biome format --write <files>

1
pnpm exec biome format --write <files>

1
bunx --bun biome format --write <files>

1
deno run -A npm:@biomejs/biome format --write <files>

1
yarn exec biome format --write <files>

lint コマンドを --write オプションを指定し実行することで、ファイルやディレクトリに対してLintを実行し、安全な修正を適用できます。

1
npx @biomejs/biome lint --write <files>

1
pnpm exec biome lint --write <files>

1
bunx --bun biome lint --write <files>

1
deno run -A npm:@biomejs/biome lint --write <files>

1
yarn exec biome lint --write <files>

check コマンドを実行することで、それら両方のコマンドを実行できます。

1
npx @biomejs/biome check --write <files>

1
pnpm exec biome check --write <files>

1
bunx --bun biome check --write <files>

1
deno run -A npm:@biomejs/biome check --write <files>

1
yarn exec biome check --write <files>

check コマンドは複数のツールを一度に実行するためのコマンドです。現在は以下のことを行います。

ファイルのフォーマット
ファイルのリント
インポートの整理

エディタプラグインのインストール

Biomeの機能を最大限活用するために、エディタプラグインをインストールすることを推奨しています。エディタのページを参照して、どのエディタがBiomeをサポートしているかを確認してください。

CIのセットアップ

Node.jsを使用している場合、BiomeをCIで実行するには、お気に入りのパッケージマネージャを使用することが推奨されます。このようにすることで、CIパイプラインがエディタ上やローカルでCLIコマンドを実行するときと同じバージョンのBiomeを使用することを保証できます。代わりに、専用のCIアクションを利用することもできます。

次のステップ

成功です！これでBiomeを使う準備が整いました。🥳

ESLintとPrettierと移行する
Biomeの設定について詳しく知る
Formatterの使い方と設定方法について詳しく知る
Linterの使い方と設定方法について詳しく知る
CLIオプションを使いこなす
設定オプションを使いこなす
Discordのコミュニティに参加する