# Bazel

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

[Bazel](https://bazel.build/) は、Google が開発したオープンソースのビルドおよびテストツールです。 複数の言語とプラットフォームにわたる複雑な依存関係を持つ大規模なコードベースを管理するように設計されています。 Bazel は、コードのコンパイル、依存関係のリンク、テストの実行、アーティファクトのデプロイのプロセスを自動化します。

Procedure: Bazel プラグインをインストールする

Bazel サポートは、IDE からインストールできる [Bazel for CLion プラグイン](https://plugins.jetbrains.com/plugin/9554-bazel-for-clion) によって提供されます。

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。

2. Bazel for CLion  プラグインを見つけ、   インストール   をクリックします。

3. IDE を再起動してプラグインを有効にします。

## プロジェクトを開く

Procedure: Bazel プロジェクトを開く

1. ようこそ画面で   オープン   をクリックします。

または、メインメニューの  `ファイル | オープン`  に移動します。

2. 開いたダイアログで、プロジェクトソースへのパスを指定します。

プロジェクトのインポート処理は   ビルド   ツールウィンドウで確認できます:

![Bazel プロジェクト同期の処理中のビルドツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel-sync-build-tool.png)

> **Tip:**
> メッセージ  `Could not run Bazel info`  が  `ビルド`  ツールウィンドウに表示される場合は、Bazel バイナリの場所が  `設定 | Bazel 設定`  で正しく設定されていることを確認してください。
>
>
>
> `.bazelversion`  ファイルを使用して Bazel バージョンを動的に解決している場合は、Bazel バイナリの場所が Bazel ではなく Bazelisk を指していることを確認してください (例:  `/opt/homebrew/bin/bazelisk` )。

### プロジェクトビューを構成する

CLion は、Bazel ワークスペースのどの部分を読み込むかを判断し、そのソースファイルにコードインサイト機能を提供するために、  `.bazelproject`  ファイルを使用します。 各ファイルは自己完結型のプロジェクト構成です: CLion がコードを同期して解決するときに、どのディレクトリとターゲットをインポートし、どのビルドフラグを Bazel に転送するかを記述します。

Bazel プロジェクトが開いた後、CLion は  `.clwb`  フォルダーにあるデフォルトのプロジェクトビューファイルを作成します。 このファイルはワークスペース全体を読み込みます。 この自動生成ファイルのほかに、切り替え可能な既存のプロジェクトビューファイルがすでにある場合があります。 アクティブな  `.bazelproject`  ファイルは、  現在  として   プロジェクト   ツールウィンドウでマークされます。

![Project ツールウィンドウで現在のものとしてマークされたアクティブな .bazelproject ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_project_view.png)

そのようなファイルの内容の例を次に示します:

```PLAINTEXT
directories:
    calc

derive_targets_from_directories: false

targets:
    //calc/...

build_flags:
    --compilation_mode=dbg

```

|   セクション   |   説明   |
| --- | --- |
|   `ディレクトリ`   |  CLion が Bazel プロジェクトに含めるワークスペースディレクトリを指定します。 ワークスペースルートを含めるには  `directories: .`  を使用できます。 特定のディレクトリを除外するには  `-some_dir`  を使用します。 これらのディレクトリは、  `derive_targets_from_directories`  が有効化されている場合に、自動ターゲット検出のスコープとしても使用されます。  |
|   `derive_targets_from_directories`   |   `true`  に設定すると、CLion は指定された  `ディレクトリ`  から使用可能な Bazel ターゲットを派生させるため、ターゲットを手動で列挙する必要はありません。  `false`  に設定すると、  `targets`  で正確なターゲットを指定する必要があります。これは大規模プロジェクトに推奨されます。  |
|   `targets`   |  CLion がインポートして同期する Bazel ターゲットを指定します。 IDE で使用可能なビルド、実行、テストターゲットを明示的に制御するには、このセクションを使用します。 CLion は [ターゲットパターン](https://bazel.build/run/build#specifying-build-targets) として  `//calc/...`  や  `//calc:all`  などをサポートしています。  |
|   `build_flags`   |  CLion が Bazel ビルド呼び出しに渡す追加の Bazel コマンドラインフラグを指定します。 構成、定義、プラットフォーム、ツールチェーン関連設定などのオプションに使用します。  |

`ディレクトリ`  と  `targets`  だけで始めて、IDE ワークスペースをさらに調整したい場合はセクションを追加できます。

> **Note:**
> プロジェクトビューファイルを操作するときは、次の点に注意してください:
>
>
>
> * 追加するすべてのセクションには、少なくともひとつのエントリが必要です。 セクションを空のままにしないでください。
>
> * ファイルを変更した後、プロジェクトを再同期します: メインメニューで `Bazel | 同期` を選択します。

### 同期モードを選択する

CLion は、メインメニュー (  `Bazel | 同期` ) で使用できる主要な同期モードを三つサポートしています:

![メインメニューの Bazel | Sync サブメニュー。CLion Bazel プロジェクトで使用可能な同期モードを一覧表示している](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_sync_modes.png)

プロジェクトをビルドファイルと同期する
: デフォルトの同期モードです。 日常的な変更のほとんどに使用します。
:
:
:
: 同期するには、ツールバーの ![Bazel のアイコン等](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.ide.expui.fileTypes.bazel.svg)   プロジェクトをビルドファイルと同期する   ボタンをクリックすることもできます:
:
:
:
: ![Bazel プロジェクトの同期を開始するビルドファイルとプロジェクトを同期するボタンを含む CLion メインツールバー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_sync_with_build_files.png)

プロジェクトをビルドファイルと非インクリメンタルに同期する
: 同期キャッシングを破棄し、プロジェクトを最初から再インポートします。 最初のトラブルシューティング手順として使用します。

部分的に同期
: 単一のディレクトリを再インポートします。 単一のディレクトリだけでビルド定義を変更した場合に使用します。 対応するディレクトリを   プロジェクト   ツールウィンドウで右クリックすると、このアクションはコンテキストメニューからも使用できます。

### アクティブな構成を切り替える

CLion はアクティブなプロジェクトビューを一度にひとつ追跡します。 切り替えるには、必要な  `.bazelproject`  ファイルを   プロジェクト   ツールウィンドウで右クリックし、   プロジェクトビューを切り替え   を選択します。

![Project ツールウィンドウでアクティブなプロジェクトビューを切り替えているところ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_switch_project_view.png)

これにより再同期がトリガーされます: CLion は選択されたスコープを再インポートし、対応するソースファイルを再度解決します。

適切な構成に切り替える例を次に示します。その後、コードが解決され、  `TEST`  の横にガターボタンが表示されます:

前:

![アクティブなプロジェクトビューを切り替える前](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_code_insight_off.png)

後:

![アクティブなプロジェクトビューを切り替えた後](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_code_insight_on.png)

切り替え後、  `calc-advanced.bazelproject`  ファイルに一覧表示されているディレクトリのみが   プロジェクト   ツールウィンドウに表示されます。

## C/C++ Bazel ターゲットを実行する

個別のテストを実行するには、そのソースファイルを開き、テストの横にあるガターの ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)   実行   アイコンをクリックします:

![エディター内の C++ テストファイル。TEST マクロの横でガターメニューが開かれ、Bazel テストターゲットの実行アクションが表示されている](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_run_target.png)

プロジェクト   ツールウィンドウから、すべてのテストターゲットを一度に実行することもできます。 ディレクトリを右クリックして、   'your_Bazel_ターゲット' を実行   を選択します。

![Project ツールウィンドウ内のディレクトリのコンテキストメニュー。対応する Bazel テストターゲットの実行アクションが表示されている](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_run_several_targets.png)

## C/C++ Bazel ターゲットをデバッグする

CLion は、デバッグフラグを自動的に挿入する代わりに、プロジェクトがデバッグシンボル付きでビルドされているかどうかを確認します。 Bazel が記録するコンパイル引数とリンク引数にデバッガーが必要とするフラグが含まれていない場合、セッションの起動後に CLion は   デバッグ情報の警告   ダイアログを表示します。

![セッションの起動後に表示されるデバッグ情報警告ダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_debug.png)

デバッグフラグを挿入して再試行   を選択すると、このダイアログからデバッグフラグを直接挿入でき、その後デバッグセッションが続行されます。 このオプションを選択すると、CLion はプロジェクトを再ビルドする必要があり、プロジェクトが大きいほど時間がかかることに注意してください。 これは、CLion が不足していると  想定 するフラグを挿入することも意味し、これらのフラグがすべてのプロジェクトのビルドセットアップに一致するとは限りません。 そのため、デフォルトのオプションは   中断   であり、  `build_flags`  を  `.bazelproject`  ファイルで手動で指定できます。

> **Tip:**
> ほとんどの場合、  `--compilation_mode=dbg`  フラグを追加するだけで十分です。

デフォルトの CLion ヒューリスティックに戻すには、  `inject_debug_flags: true`  を  `.bazelproject`  ファイルに追加します。

この仕組みについて詳しく見るには、 [GitHub ドキュメント](https://github.com/bazelbuild/intellij/blob/master/docs/cpp/debugging.md)を参照してください。

## Starlark サポート

[Starlark](https://bazel.build/rules/language) は、Bazel がビルドターゲット、ルール、マクロ、拡張機能を定義するために使用する小規模な Python 風の構成言語で、通常は  `BUILD` 、  `BUILD.bazel` 、  `.bzl`  ファイルで使われます。 CLion では、Starlark コードをデバッグし、REPL (Read-Eval-Print Loop) を使用できます。REPL は Starlark の式やステートメントを評価する対話型インタープリターです。

Procedure: Starlark コードをデバッグする

1. [ブレークポイントを設定](using-breakpoints.html#set-breakpoints)します。  `.bzl`  ファイル内で行います。

2. `BUILD`  ファイルで、デバッグ構成の横にあるガターの ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)   実行   アイコンをクリックし、   Starlark をデバッグ: 'your_Bazel_ターゲット'   を選択します。

![エディター内のビルドファイル。ガターメニューが開いており、Bazel ターゲットのデバッグ Starlark アクションが選択されています](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_starlark_debug_icon.png)

デバッグセッションが開始されてブレークポイントで停止し、その後、Starlark マクロなどの [コードを調査](examining-suspended-program.html)できます。

![一時停止中の Starlark デバッグセッション。.bzl ファイル内の停止行とデバッグツールウィンドウ内のローカル変数が表示されている](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bazel_starlark_debug.png)

Procedure: REPL を使用する

REPL は、  `.bzl`  ファイルを作成せずに、Starlark 構文をすばやく確認したり、小さなコードスニペットを試したり、関数を試験的に実行したりするのに便利です。

1. メインメニューの  `Bazel`  に移動し、   Starlark REPL   を選択します。 ツールは   実行   ツールウィンドウで開きます。

2. Starlark の式またはステートメントを入力し、 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押して評価します。

## See also

### JetBrains ブログ投稿集

[Enhancing Bazel Support in CLion](https://blog.jetbrains.com/clion/2025/07/bazel-for-clion/) [Custom Toolchains and Windows Support](https://blog.jetbrains.com/clion/2025/04/new-features-in-bazel-plugin/)

