# Compilation database

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

[CMake](quick-cmake-tutorial.html)、 [Gradle](gradle-support.html)、 [Makefiles](makefiles-support.html) に基づいていないプロジェクトで作業している場合でも、CLion が提供する高度な IDE 機能を利用できます。 非 CMake プロジェクトを [インポート](creating-new-project-from-scratch.html#import-prj)し、CLion でシンプルな CMake 構造に変換する方法もあります。 別のオプションは、   compilation database   をロードしてプロジェクトを開くことです。

compilation データベースを使用すると、CLion がプロジェクトファイルを検出し、インクルードパスやコンパイルフラグなど、必要なすべてのコンパイラー情報を抽出できます。 このアプローチにより、プロジェクトを CMake、Makefile、Gradle から  独立さ せたまま、IDE で操作し、その機能を完全に体験することができます。

[compilation database(英語)](https://clang.llvm.org/docs/JSONCompilationDatabase.html) は、  `compile_commands.json`  という名前の [JSON(英語)](https://www.json.org/) -formatted ファイルであり、プロジェクト内のすべてのコンパイル単位に関する構造化データが含まれています。

次のスニペットは、JSON コンパイルデータベースの例を示しています。

```JSON
{
"directory": "/Users/me/prj/Calendar/",
"command": "/usr/local/bin/g++-7 -I/Users/me/prj/Calendar/calendars -g -std=c++11 -o calendar_run.dir/main.cpp.o -c /Users/me/prj/Calendar/main.cpp",
"file": "/Users/me/prj/Calendar/main.cpp"
},
{
"directory": "/Users/me/prj/Calendar/calendars",
"command": "/usr/local/bin/g++-7 -I/Users/me/prj/Calendar/calendars -g -std=c++11 -o calendars.dir/calendar_defs.cpp.o -c /Users/me/prj/Calendar/calendars/calendar_defs.cpp",
"file": "/Users/me/prj/Calendar/calendars/calendar_defs.cpp"
}

```

コマンドオブジェクト と呼ばれるエントリの配列が表示されます。 各  コマンドオブジェクトは 、翻訳単位のメイン   ファイル   、作業   ディレクトリ   、実際のコンパイル   command   (または   引数を指定できます。   のリスト)、およびオプションでコンパイルステップによって作成された   output   の名前を表します。 形式の詳細については、 [公式ドキュメント(英語)](http://clang.llvm.org/docs/JSONCompilationDatabase.html#format)を参照してください。

## compilation database の生成

プロジェクト用の compilation データベースを取得するには、さまざまな方法があります。コンパイラー、ビルドシステム、専用ツールで生成できます（ [バリアントの詳細なリスト](https://sarcasm.github.io/notes/dev/compilation-database.html)を参照）。 いくつかの例を以下に示します：

Procedure: CMake：

* [CMAKE_EXPORT_COMPILE_COMMANDS(英語)](https://cmake.org/cmake/help/v3.11/variable/CMAKE_EXPORT_COMPILE_COMMANDS.html) フラグを使用してください。 走れる

```CONSOLE
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .
```

[set(CMAKE_EXPORT_COMPILE_COMMANDS ON)](cmakelists-txt-file.html)

```CONSOLE
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
```

`compile_commands.json`  ファイルはビルドディレクトリに配置されます。

> **Note:**
> `CMAKE_EXPORT_COMPILE_COMMANDS`  は、Makefile および Ninja [ジェネレーター(英語)](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html#makefile-generators)によってのみ実装されます。 他のジェネレーターの場合、このオプションは無視されます。

Procedure: Clang（バージョン 5.0 以降）:

* [-Mj(英語)](http://bcain-llvm.readthedocs.io/projects/clang/en/latest/ClangCommandLineReference/#cmdoption-clang-mj-arg) オプションは、入力ファイルごとにコンパイルエントリを書き込みます。 これをプロジェクト内の各ファイルに使用し、出力を JSON 形式の compilation database にマージできます ( [手順の例(英語)](https://github.com/Sarcasm/notes/blob/master/dev/compilation-database.rst#clang)を参照)。

Procedure: Ninja（バージョン 1.2 以降）:

* compilation データベースを取得するには、 [-t compdb](https://ninja-build.org/manual.html#_extra_tools) オプションを使用します。 この場合、引数としてルール名を指定する必要があります：  `-t compdb rule1 rule2...`  ルール一覧は Ninja ビルドファイル（デフォルト名 [build.ninja](https://ninja-build.org/manual.html)）に記載されています。例えば：

```CONSOLE
rule cc
    command = gcc -c -o $out $in
    description = CC $out

rule link
    command = gcc -o $out $in
    description = LINK $out
                    
```

ルール名が  `cc`  のみの場合、次のように指定して compilation データベースを生成します：

```CONSOLE
-t compdb cc > compile_commands.json
```

複数のルールの場合は、ビルドファイルから正確な名前を取得し、それらを  `compdb`  に渡す必要があります（ [考えられる解決策の一つ](https://sarcasm.github.io/notes/dev/compilation-database.html#ninja)を参照）。

Procedure: メイクベースのプロジェクト:

* [compiledb-generator(英語)](https://github.com/nickdiego/compiledb-generator) ツールは、メイクベースのビルドシステム用のコンパイルデータベースを作成します。

Procedure: Bear と intercept-build ツール:

* [scan-build(英語)](https://github.com/rizsotto/scan-build) の [Bear(英語)](https://github.com/rizsotto/Bear) と   intercept-build   は、ビルド中にコンパイラー呼び出しをインターセプトすることにより、compilation database を取得するのに役立つツールです。

Procedure: SourceTrail Visual Studio 拡張機能:

* [SourceTrail エクステンション(英語)](https://marketplace.visualstudio.com/items?itemName=vs-publisher-1208751.SourcetrailExtension)は、 [Visual Studio ソリューション](https://learn.microsoft.com/en-us/visualstudio/ide/solutions-and-projects-in-visual-studio)用のコンパイルデータベースを生成します。

## CLion で compilation database を操作する

プロジェクト用の compilation データベースを作成したら、CLion で作業を開始できます。

Procedure: プロジェクトを読み込む

1. メインメニューから  `ファイル | オープン`  を選択します。

2. `compile_commands.json`  ファイルまたはそれが含まれるディレクトリを見つけて、「   オープン   」をクリックします。

3. プロジェクトとして開く​   をクリックします：

![compilation database プロジェクトを開く](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compdb_openasproject.png)

4. CLion はプロジェクトファイルを検出し、  `compile_commands.json`  のすべてのコマンドのステータスを   ビルド   ツールウィンドウに表示します：

![Compilation database プロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compdb_overview.png)

この時点で、CLion のコードインサイト、リファクタリング、分析、ナビゲーションがプロジェクトで完全に利用できるようになります。

> **Tip:**
> プロジェクトファイルは、  `compile_commands.json`  が含まれるディレクトリの外に配置できます。 CLion は compilation データベースから実際のパスを抽出し、場所に関係なくプロジェクトファイルを収集します。

> **Note:**
> VCS で compilation データベースプロジェクトを操作する場合は、取り込み時に  `.iml`  ファイルが再生成されるため、そのファイルを共有しないことを検討してください。 詳細については、 [この説明](https://intellij-support.jetbrains.com/hc/en-us/articles/206544839-How-to-manage-projects-under-Version-Control-Systems)を参照してください。

Procedure: ツールチェーンを確認する

1. `設定 | ビルド、実行、デプロイ | Compilation Database`  へ

2. プロジェクトファイルの解決に使用するツールチェーンを選択します。

![compilation database のツールチェーン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compdb_wsl_toolchain.png)

CLion は、  `設定 | ビルド、実行、デプロイ | ツールチェーン`  から利用可能なすべてのツールチェーンを提案します。   リモートホスト   ツールチェーンは現在 compilation database プロジェクトではサポートされていないことに注意してください。

> **Note:**
> ツールチェーンを変更するには、新しいツールチェーンを使用して  `compile_commands.json`  ファイルを再生成する必要があることに注意してください。

Procedure: プロジェクトルートの変更

デフォルトでは、プロジェクトのルートは compilation データベースファイルが含まれるディレクトリに設定されます。 ただし、これは常に便利とは限りません。たとえば、一部のプロジェクトファイルが  `compile_commands.json`  を含むディレクトリの外（つまりプロジェクトルートの外）にある場合、そのようなファイルは実際のフォルダー構造に関係なくツリーに表示されます。 この場合、プロジェクトルートを  `compile_commands.json`  とプロジェクトファイルが両方含まれる親ディレクトリに設定する必要があります。

1. プロジェクトルートを変更するには、メインメニューから  `ツール | Compilation Database | プロジェクトルートを変更する`  を選択し、プロジェクトルートの新しい場所を設定します。

Procedure: 自動再読み込みを設定する

デフォルトでは、VCS 更新などの外部イベントの場合を除いて、CLion は  `compile_commands.json`  の変更時にプロジェクトを自動的に再読み込みしません。 この動作は、   ビルドツール   設定で変更できます。

1. `設定 | ビルド、実行、デプロイ | ビルドツール`  に進みます。

2. 自動再読み込みオプションのいずれかを選択します。

![自動再ロードの設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_autoreload_settings.png)

* 任意の変更 - プロジェクトの再ロードは、 `compile_commands.json` が変更されるとトリガーされます。

* 外部の変更 （デフォルト）- プロジェクトは、VCS 更新などの外部イベントが発生したときにのみ再ロードされます。 `compile_commands.json` で他の変更があった場合は、プロジェクトを手動で再ロードする必要があります。 次のいずれかのオプションを使用します。 * ボタン `Ctrl+Shift+O` (Windows), `⌘ ⇧ I` (macOS), `⌘ ⇧ O` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ I` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `⌘ ⇧ I` (Sublime Text (macOS)), `⌘ ⇧ I` (Xcode), `Ctrl+Shift+O` (Visual Studio), `⌘ ⇧ I` (Visual Studio (macOS)), `Ctrl+Shift+O` (ReSharper), `⌘ ⇧ I` (ReSharper (macOS)), `Ctrl+Shift+O` (QtCreator), `Ctrl+Shift+O` (QtCreator (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS)) * エディターに表示されるポップアップをクリックします： ![プロジェクトを再ロードするためのエディターポップアップ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compdb_reload_popup.png) * ビルド ツールウィンドウで ![Reimport Compilation Database Project](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.refresh.svg)をクリックします： ![プロジェクトの再インポートアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compdb_reimport_syncwindow.png) * メインメニューから `ツール | Compilation Database | Compilation Database プロジェクトを再ロード` を選択します。

> **Tip:**
> この設定はプロジェクトごとに機能します。 自動再読み込みオプションは、compilation データベース、 [Makefile](makefiles-support.html)、 [Gradle](gradle-support.html) プロジェクトごとに個別に構成する必要があります。

### compile_database.json のコーディング支援

CLion は [JSON](clion-features-in-different-languages.html) ファイルフォーマットをネイティブにサポートしているため、IDE 内で  `compile_database.json`  ファイルを編集でき、ハイライトやコード補完によるヘルプが利用できます：

![コード補完 (compile_database.json)](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compdb_jsoncompletion.png)

CLion は、  `compile_database.json`  ファイルが compilation データベース JSON スキーマに準拠しているかをチェックします。  `設定 | エディター | インスペクション | JSON および JSON5`  で対応するインスペクションを調整できます。

![JSON インスペクション (compile_database.json 用)](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compdb_jsoninspections.png)

### 1 つのファイルをコンパイルする

compilation データベースプロジェクトのビルド機能は CLion にはまだ実装されていませんが、プロジェクト全体をビルドせずに単一ファイルの変更を確認できて便利な場合があります。 この目的のために、CLion は [再コンパイル](compiling-single-file.html)アクションを提供します。 個々のソースファイルとヘッダーファイル、およびプロジェクトツリーで選択されたファイルのグループにも利用できます。 ヘッダーの場合、CLion は resolve コンテキストを使用して、指定されたヘッダーを含むソースファイルのいずれかをコンパイルします。   再コンパイル   は、ディレクトリおよび C/C++ 以外のファイルでは無効になっています。

* 現在開いているファイルの 再コンパイル を呼び出すには、メインメニューから `ビルド | 再コンパイル` を選択するか、 `Ctrl+Shift+F9` (Windows), `⌘ ⇧ F9` (macOS), `⌘ ⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F9` (macOS System Shortcuts), `Ctrl+Shift+F9` (XWin), `Ctrl+Shift+F9` (GNOME), `Ctrl+Shift+F9` (KDE), `Ctrl+Shift+F9` (Emacs), `Ctrl+B` (Sublime Text), `⌘ B` (Sublime Text (macOS)), `⌘ ⇧ F9` (Xcode), `Ctrl+F7` (Visual Studio), `⌘ F7` (Visual Studio (macOS)), `Ctrl+F7` (ReSharper), `⌘ F7` (ReSharper (macOS)), `Ctrl+Alt+B` (QtCreator), `⌘ ⌥ B` (QtCreator (macOS)), `F9` (NetBeans), `Ctrl+Shift+F9` (Eclipse), `⌘ ⇧ F9` (Eclipse (macOS)) を押します。

* プロジェクトツリー内のファイルの場合は、コンテキストメニューの 再コンパイル オプションを使用します (または同じ `Ctrl+Shift+F9` (Windows), `⌘ ⇧ F9` (macOS), `⌘ ⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F9` (macOS System Shortcuts), `Ctrl+Shift+F9` (XWin), `Ctrl+Shift+F9` (GNOME), `Ctrl+Shift+F9` (KDE), `Ctrl+Shift+F9` (Emacs), `Ctrl+B` (Sublime Text), `⌘ B` (Sublime Text (macOS)), `⌘ ⇧ F9` (Xcode), `Ctrl+F7` (Visual Studio), `⌘ F7` (Visual Studio (macOS)), `Ctrl+F7` (ReSharper), `⌘ F7` (ReSharper (macOS)), `Ctrl+Alt+B` (QtCreator), `⌘ ⌥ B` (QtCreator (macOS)), `F9` (NetBeans), `Ctrl+Shift+F9` (Eclipse), `⌘ ⇧ F9` (Eclipse (macOS)) キーを押します)。

* 複数のファイルを再コンパイルするには、プロジェクトツリーでファイルを選択し、コンテキストメニュー `Ctrl+Shift+F9` (Windows), `⌘ ⇧ F9` (macOS), `⌘ ⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F9` (macOS System Shortcuts), `Ctrl+Shift+F9` (XWin), `Ctrl+Shift+F9` (GNOME), `Ctrl+Shift+F9` (KDE), `Ctrl+Shift+F9` (Emacs), `Ctrl+B` (Sublime Text), `⌘ B` (Sublime Text (macOS)), `⌘ ⇧ F9` (Xcode), `Ctrl+F7` (Visual Studio), `⌘ F7` (Visual Studio (macOS)), `Ctrl+F7` (ReSharper), `⌘ F7` (ReSharper (macOS)), `Ctrl+Alt+B` (QtCreator), `⌘ ⌥ B` (QtCreator (macOS)), `F9` (NetBeans), `Ctrl+Shift+F9` (Eclipse), `⌘ ⇧ F9` (Eclipse (macOS)) から 選択したファイルを再コンパイルする オプションを使用します。 複数のファイルに使用すると、最初のコンパイルが失敗すると再コンパイルが停止することに注意してください。

再コンパイル   ファイルを処理する際、CLion は  `compile_commands.json`  内の対応する  コマンドオブジェクト から必要な情報、つまりコンパイルコマンドライン（CLion は出力を抑制し、出力ファイルを指定するフラグを削除します）および使用するコンパイラーを抽出します。

### ディレクトリとしてマーク。。

ディレクトリをマーク   アクションは、compilation database プロジェクトでも使用できます。 プロジェクトツリーでディレクトリを選択し、右クリックして、   ディレクトリをマーク   アクションを選択します。

ユースケース説明や、CLion がマークされたディレクトリをどのように扱うかの詳細については、セクション [外部ソースファイル](controlling-source-library-and-exclude-directories.html) を参照してください。

### ビルドと実行

Compilation database 自体には   ビルド、実行、デバッグ   アプリケーションに必要なデータがありません。 ただし、compilation データベースプロジェクト用に [カスタムビルドターゲット](custom-build-targets.html)を追加し、それらのターゲット用に [カスタム実行／デバッグ構成](custom-build-targets.html#custom-rundebug)を作成することで、ワークフローを設定できます。

## See also

### 外部リンク

[Working with Makefiles in CLion using Compilation DB and File Watchers](https://blog.jetbrains.com/clion/2018/08/working-with-makefiles-in-clion-using-compilation-db/)

