Biomeの設定

設定ファイル

Biomeはデフォルトで十分な機能を提供するので、設定ファイルの使用はオプショナルです。 デフォルトの挙動を変更したい時に設定ファイルを使用してください。

Biomeの設定ファイルは biome.json という名前で、プロジェクトのルートディレクトリに置く必要があります。 通常、プロジェクトの package.json が置かれているところがルートディレクトリになります。

例えば、以下の設定ファイルはフォーマッタを有効にし、インデントスタイルと幅を設定します。リンタは無効になっています：

{
  "formatter": {
    "enabled": true,
    "indentStyle": "tab",
    "lineWidth": 120
  },
  "linter": {
    "enabled": false
  }
}

デフォルトの設定

biome init を実行すると、以下のデフォルト設定が出力されます：

biome.json

{
  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
  "vcs": {
    "enabled": false,
    "clientKind": "git",
    "useIgnoreFile": false
  },
  "files": { "ignoreUnknown": false, "ignore": [] },
  "formatter": { "enabled": true, "indentStyle": "tab" },
  "organizeImports": { "enabled": true },
  "linter": {
    "enabled": true,
    "rules": { "recommended": true }
  },
  "javascript": { "formatter": { "quoteStyle": "double" } }
}

設定ファイルの解決

Biomeは最も近い biome.json を自動で検出します。 実行時のディレクトリから biome.json を探索し、以下の条件を満たすまで親ディレクトリを探索します：

• biome.json ファイルが見つかった場合
• biome.json が見つからなかった場合、Biomeのデフォルト設定を適用します

例えば以下のようなディレクトリ構成の場合：

└── app
    ├── backend
    │   ├── package.json
    │   └── biome.json
    └── frontend
        ├── legacy
        │   └── package.json
        ├── new
        │   └── package.json
        └── biome.json

• app/backend/package.json で実行されたbiomeコマンドは app/backend/biome.json を使用します
• app/frontend/legacy/package.json や app/frontend/new/package.json で実行されたbiomeコマンドは app/frontend/biome.json を使用します

既知のファイル

以下のファイルは現在Biomeによって無視されます。 つまり、これらのファイルに対してBiomeは何も診断を行いません。

• package.json
• package-lock.json
• npm-shrinkwrap.json
• yarn.lock
• composer.json
• composer.lock
• typescript.json
• tsconfig.json
• jsconfig.json
• deno.json
• deno.jsonc

json.parser.allowComments と json.parser.allowTrailingCommas オプションが true に設定されている時、以下のファイルは JSON ファイル としてパースされます。 これは、VSCodeなどのエディタがそのように扱うためです。

• tslint.json
• babel.config.json
• .babelrc.json
• .ember-cli
• typedoc.json
• .eslintrc
• .eslintrc.json
• .jsfmtrc
• .jshintrc
• .swcrc
• .hintrc
• .babelrc