Zed拡張機能

インストール方法

Zed >= v0.131.0 が必要です。

この拡張機能は、Zedエディタの拡張機能ビューで利用できます。 zed: extensions を開き、 Biome を検索してください。内部でBiomeバイナリを実行し、以下の順序でBiomeのインストールを確認します：

Zedの設定で指定されたパス、例えば：

1
{
2
  "lsp": {
3
    "biome": {
4
     "binary": {
5
        "path": "/var/biome-2.2.3/bin/biome",
6
        "arguments": [
7
          "lsp-proxy"
8
       ]
9
      }
10
    }
11
  }
12
}

package.json 経由でローカルにインストールされたBiome
PATH にシステム全体にインストールされたBiome

いずれも存在しない場合、Biomeを npm でインストールして使用するようZedに依頼します。

設定

`config_path`

デフォルトでは、設定ファイルはワークスペースのルートに配置する必要があります。

それ以外の場合は、LSP設定を通じて構成できます：

1
{
2
  "lsp": {
3
    "biome": {
4
      "settings": {
5
        "config_path": "<path>/biome.json"
6
      }
7
    }
8
  }
9
}

`require_config_file`

プロジェクトに設定ファイルが含まれている場合にのみBiomeを有効にします：

デフォルト: false

1
{
2
  "lsp": {
3
    "biome": {
4
      "settings": {
5
        "require_config_file": true
6
      }
7
    }
8
  }
9
}

`inline_config`

Biome設定のインラインバージョン。この設定のオプションは、ディスクから読み取られた biome.json ファイル（またはデフォルト値）のオプションを上書きします。

例えば、プロジェクトで noConsole ルールを error の重大度で有効にしているとします：

1
{
2
  "linter": {
3
    "rules": {
4
      "suspicious": {
5
        "noConsole": "error"
6
      }
7
    }
8
  }
9
}

しかし、ローカル開発中は、このルールが便利で赤い波線を見たくないため、このルールを無効にしたいとします。 inline_config には、次のように記述します：

1
{
2
  "lsp": {
3
    "biome": {
4
      "settings": {
5
        "inline_config": {
6
          "linter": {
7
            "rules": {
8
              "suspicious": {
9
                "noConsole": "off"
10
              }
11
            }
12
          }
13
        }
14
      }
15
    }
16
  }
17
}

フォーマット

言語サーバーをフォーマッタとして使用するには、設定で biome をフォーマッタとして指定してください：

1
{
2
  "languages": {
3
    "Astro": { "formatter": { "language_server": { "name": "biome" } } },
4
    "CSS": { "formatter": { "language_server": { "name": "biome" } } },
5
    "GraphQL": { "formatter": { "language_server": { "name": "biome" } } },
6
    "HTML": { "formatter": { "language_server": { "name": "biome" } } },
7
    "JSON": { "formatter": { "language_server": { "name": "biome" } } },
8
    "JSONC": { "formatter": { "language_server": { "name": "biome" } } },
9
    "JSX": { "formatter": { "language_server": { "name": "biome" } } },
10
    "JavaScript": { "formatter": { "language_server": { "name": "biome" } } },
11
    "Svelte": { "formatter": { "language_server": { "name": "biome" } } },
12
    "TSX": { "formatter": { "language_server": { "name": "biome" } } },
13
    "TypeScript": { "formatter": { "language_server": { "name": "biome" } } },
14
    "Vue.js": { "formatter": { "language_server": { "name": "biome" } } },
15
  }
16
}

詳細については、言語サポートを参照してください。

biome.jsonが存在する場合にのみBiomeを有効にする

1
{
2
  "lsp": {
3
    "biome": {
4
      "settings": {
5
        "require_config_file": true
6
      }
7
    }
8
  }
9
}

フォーマット時にコードアクションを実行する：

1
{
2
  "languages": {
3
    "JavaScript": {
4
      "formatter": { "language_server": { "name": "biome" } },
5
      "code_actions_on_format": {
6
        "source.fixAll.biome": true,
7
        "source.organizeImports.biome": true
8
      }
9
    },
10
    "TypeScript": {
11
      "formatter": { "language_server": { "name": "biome" } },
12
      "code_actions_on_format": {
13
        "source.fixAll.biome": true,
14
        "source.organizeImports.biome": true
15
      }
16
    },
17
    "TSX": {
18
      "formatter": { "language_server": { "name": "biome" } },
19
      "code_actions_on_format": {
20
        "source.fixAll.biome": true,
21
        "source.organizeImports.biome": true
22
      }
23
    }
24
  }
25
}

安全でない修正を保存時に適用したい場合は、ルールのコード修正を安全にする必要があります。

プロジェクトベースの設定

これらの設定は、プロジェクトフォルダのルートにあるZedプロジェクト設定（.zed/settings.json）に含めるか、すべてのプロジェクトにデフォルトで適用されるZedユーザー設定（~/.config/zed/settings.json）に含めることができます。

特定のプロジェクトでBiomeを無効にする

プロジェクトで特定の言語（例：GraphQL）のBiomeを除外できます：

1
{
2
  "languages": {
3
    "GraphQL": {
4
      "language_servers": [ "!biome", "..." ]
5
    }
6
  }
7
}

グローバル設定

Zed settings.jsonのトップレベルの language_servers、formatter、または code_actions_on_format キーに biome を追加することは推奨されません。language_server または formatter として biome をグローバルに指定すると、Biomeがサポートしていない言語（Rust、Pythonなど）の機能が壊れる可能性があります。サポートされている言語の完全なリストについては、言語サポートを参照してください。

このドキュメントでは以前、グローバル設定を推奨していました。Zedの設定を言語ごとにBiomeを明示的に設定するように切り替えてください。