# カスタムコンパイラー

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

使用しているコンパイラーが CLion で [デフォルトでサポートされていない](how-to-switch-compilers-in-clion.html)場合は、  カスタムコンパイラー オプションに切り替えてください。 まだ公開されていない可能性のあるまれなコンパイラーであっても、IDE にまだ知られていないコンパイラーを定義できます。 このオプションは、 [組み込み開発](embedded-stm32.html)に特に役立ちます。

> **Tip:**
> CLion ブログの [CLion のカスタムコンパイラー: CLion で任意のコンパイラーを使用するためのクイックガイド(英語)](https://blog.jetbrains.com/clion/2022/09/custom-compilers/)を参照してください。

Procedure: コンパイラーの説明を準備する

CLion でカスタムコンパイラーを使用するには、その説明を   YAML   フォーマットで記述した構成ファイルを作成する必要があります。

* カスタムコンパイラー YAML ファイルでは、コンパイラーに関する次の詳細を特定する必要があります。

* サポートされている言語: サポートされているすべての言語または言語バリアントには、少なくとも 1 つの構成セクションが必要です。

* コンパイラーバイナリ名（複数の場合あり）: 一部のツールチェーンでは、C と C++、異なるメモリモデル、言語バリアントなどで異なるコンパイラーバイナリが用意されています。この情報はツールチェーンのドキュメントで確認できます。

* 標準インクルードディレクトリの場所: これらのディレクトリを特定するには、コンパイラーのドキュメントを読むか、インストールされているツールチェーンフォルダーツリーを調べます。

* 定義済みマクロのリスト: 一部のコンパイラーは定義済みマクロのリストを報告できますが、できないコンパイラーもあります。使用しているコンパイラーで定義済みマクロを取得する方法については、コンパイラーのドキュメントを参照してください。

カスタムコンパイラー構成フォーマットには、レコードのリストを含む必須の  compilers セクションがあります。 すべてのレコードには、コンパイラーの説明とコンパイラー呼び出しを識別するいくつかのタグがあります。

最初に一致するレコードは、システム定義マクロのリスト、Clangd のターゲットプラットフォーム名、およびシステムヘッダーパスのリストを含む、CLion 言語エンジンのコンパイラー情報を提供するために使用されます。

![カスタムコンパイラーの設定例](https://resources.jetbrains.com/help/img/idea/2026.3/cl_customcompiler_yaml_example.png)

|  |  |
| --- | --- |
|   `description`   |  コンパイラー名 (必須パラメーター)  |
|   `match-sources`   |  ソースファイル名の正規表現  |
|   `match-compiler-exe`   |  その名前のコンパイラーを任意の場所から使用するために必要な、コンパイラー実行可能ファイル名の正規表現（必須パラメーター）  |
|   `match-args`   |  コンパイラーのコマンドラインキー  |
|   `match-language`   |  検出された言語、C または CPP (CMake にのみ必要)  |
|   `code-insight-target-name`   |  [Clangd](settings-languages-cpp-clangd.html) のターゲットプラットフォーム名  |
|   `include-dirs`   |  コンパイラー固有のヘッダー検索パス。この設定で使用できる変数は  `${compiler-exe}` 、  `${compiler-exe-dir}` 、  `${user-home}` 、  `${project-path}`  です。  |
|   `defines`   |   `'name: value'`  YAML 形式のコンパイラー固有のマクロ (  `value`  部分は空にすることができます)  |
|   `defines-text`   |   `'#define name value'`  C 形式のコンパイラー固有のマクロ (  `value`  部分は空にすることができます)  |

> **Tip:**
> 役立つ   ヒント   :
>
>
>
> * 1 つのファイルで複数のコンパイラーを定義できます。
>
> * `.yaml` ファイルの一部は、標準の YAML [アンカー / エイリアス(英語)](https://yaml.org/spec/1.2.2/#3222-anchors-and-aliases)構文を使用して再利用できます。 再利用された部品のコンテナーとして、構造化されていないオプションの `aliases` セクションが存在する場合があります。
>
> * Clangd が実際のプラットフォームをサポートしていない場合は、同じビット数、同じバイト順序などで最も近いアナログを使用してみてください。 例: 8 ビットプラットフォームは `avr` として宣言される場合があります。
>
> * コンパイラーにカスタム言語キーワード（TI コンパイラーの `_DATA_ACCESS` など）がある場合は、赤いコードを避けるために、 `defines:` ブロックに空のシンボルとして入れてください。

* 始めるのに役立つ [いくつかの例(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples)を用意しました。 そのまま使用することも、独自の構成を作成するためのテンプレートとして使用することもできます。

* [Embarcadero FreeC コンパイラー (英語)](https://www.embarcadero.com/ru/free-tools/ccompiler) : [構成ファイル(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples/blob/master/CMake-Embarcadero-BCC32C/custom-compiler-bcc.yaml)、 [テストプロジェクト(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples/tree/master/CMake-Embarcadero-BCC32C)。

* [MSP430MCU 用の TexasInstruments コード生成ツール (英語)](https://www.ti.com/tool/MSP-CGT#downloads) : [構成ファイル(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples/blob/master/CMake-Texas-Instruments-MSP430-CGT/custom-compiler-msp430.yaml)、 [テストプロジェクト(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples/tree/master/CMake-Texas-Instruments-MSP430-CGT)。

* [stm8 の SDCC(英語)](http://sdcc.sourceforge.net/) : [構成ファイル(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples/blob/master/CMake-SDCC/custom-compiler-sdcc-stm8.yaml)、 [テストプロジェクト(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples/tree/master/CMake-SDCC)。

> **Note:**
> カスタムコンパイラー用に独自の構成を準備する場合は、 [GitHub リポジトリ(英語)](https://github.com/JetBrains/clion-custom-defined-compiler-examples/tree/master/configs)でプルリクエストを作成して、公開し、コミュニティと共有することをお勧めします。

Procedure: ツールチェーン設定で .yaml 構成を指定する

1. `設定 | ビルド、実行、デプロイ | ツールチェーン | カスタムコンパイラー`  に進みます。

2. カスタムコンパイラー構成を使用する (* .yaml)   チェックボックスを設定し、パスを指定します。

![カスタムコンパイラー構成設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_customcompiler_enable_setting.png)

> **Note:**
> これはプロジェクトごとの設定です。

3. ツールチェーン   ダイアログに切り替えて、編集するツールチェーンを選択するか、新しい [ツールチェーンを作成](how-to-create-toolchain-in-clion.html#new-toolchain)します。

4. C コンパイラー   フィールドと   C++ コンパイラー   フィールドのパスをカスタムコンパイラーに変更します。

![ツールチェーン設定でカスタムコンパイラーを指定する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_customcompiler_toolchain_settings.png)

または、Makefile で手動、または [CMake プロファイル](cmake-profile.html)設定を通じてカスタムコンパイラーを渡すこともできます。 この場合、カスタムコンパイラーは現在のプロジェクトにのみ使用されます。

Procedure: カスタムコンパイラーを確認する

カスタムコンパイラーが正常に構成されている場合、コードは正しく解決され、アシストアクションのコーディングはすべて期待どおりに機能します。 カスタムコンパイラーが正しく設定されていることを再確認するには、次の手順を実行します。

1. [CMake](reloading-project.html)、 [Makefile](makefiles-support.html#load-makefile-project)、 [compilation database](compilation-database.html#compdb_load) プロジェクトをロードします。

2. いずれかの C/C++ プロジェクトファイルをエディターで開きます。

3. メインメニューから  `ヘルプ | 診断ツール | コンパイラー情報を表示する`  を呼び出します。

4. すべて問題がなければ、構成ファイルで定義されているコンパイラーのタイプと名前、およびコンパイラーで事前定義されたマクロのリストが表示されます。

![コンパイラー情報ビュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_customcompiler_showcompilerinfo.png)

Procedure: CLion で .yaml 設定を編集する

* CLion はデフォルトで YAML 言語をサポートします（ [さまざまな言語の CLion 機能](clion-features-in-different-languages.html) を参照）。 スキーマ固有の検証、コード補完、クイックドキュメント、およびその他のアクションを取得するには、   カスタムコンパイラー定義   スキーマに切り替えます。

`.yaml`  構成を開き、下部にある IDE のステータスバーのスキーマスイッチャーをクリックして、   カスタムコンパイラー定義   を選択します。

![YAML カスタムコンパイラー構成スキーマ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_yaml_schema.png)

## See also

### チュートリアル

[Custom Compilers in CLion: A Quick Guide to Using an Arbitrary Compiler in CLion (blog post)](https://blog.jetbrains.com/clion/2022/09/custom-compilers/)

### ハウツー

[組み込み開発](embedded-overview.html) [コンパイラー](how-to-switch-compilers-in-clion.html) [ツールチェーン](how-to-create-toolchain-in-clion.html)

### プロシージャ

[Quick CMake Tutorial](quick-cmake-tutorial.html) [Makefile projects](makefiles-support.html) [Compilation database](compilation-database.html)

