はじめる

インストール方法

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

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

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

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

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

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

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

deno add --dev npm:@biomejs/biome

Biomeをインストールする際には、バージョン範囲演算子を使用しないことを強く推奨しています。詳しくは、バージョニングページをご覧ください。

設定

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

設定を作成するには、プロジェクトのルートディレクトリで init コマンドを実行します。

npx @biomejs/biome init

yarn biome init

pnpm biome init

bunx biome init

deno run -A npm:@biomejs/biome init

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

{
  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
  "organizeImports": {
    "enabled": false
  },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true
    }
  }
}

linter.enabled: true はリンタを有効にし、 rules.recommended: true は推奨ルールを有効にします。

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

使い方

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

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

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

yarn biome format --write <files>

pnpm biome format --write <files>

bunx biome format --write <files>

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

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

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

yarn biome lint --write <files>

pnpm biome lint --write <files>

bunx biome lint --write <files>

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

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

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

yarn biome check --write <files>

pnpm biome check --write <files>

bunx biome check --write <files>

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

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

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

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

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

CIのセットアップ

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

次のステップ

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

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