# CMake プロファイル

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

CMake プロジェクトのビルドに必要な設定は   CMake プロファイル   に組み込まれています。 これには [ツールチェーン](how-to-create-toolchain-in-clion.html)と [ビルド型](#buildtypes)に加えて、 [ジェネレーター](#cmake-generators)や [環境変数](#EnvVariables)などの CMake オプションが含まれます。

たとえば、異なるコンパイラーを使用したり、異なる設定でターゲットをビルドしたりするために、プロジェクトに複数のプロファイルを構成できます。

Procedure: プロファイル設定にアクセスする

次のいずれかを実行して、CMake プロファイル設定を開きます。

* `設定 | ビルド、実行、デプロイ | CMake`  に進みます。

* `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) を押して   アクションの検索  ダイアログを開き、  CMake の設定 を検索します：

![C 検索アクションで設定を行う](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_settings_findaction.png)

* `設定 | キーマップ` に移動して、 [ショートカットを割り当てる](configuring-keyboard-and-mouse-shortcuts.html#add-keyboard-shortcut)で CMake 設定のショートカットを設定してください。 このショートカットを使うと、CMake の設定ページをすばやく開けます。

![CMake 設定のショートカットの割り当て](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_settings_keymap.png)

> **Note:**
> CMake プロファイルはプロジェクトごとに構成されます。

Procedure: 新しいプロファイルを追加する

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

2. ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックすると、CLion が新しいプロファイルをリストに追加します。

3. 必要に応じて、プロファイル名、ビルドタイプ、その他の設定を変更します。

Procedure: プロファイルで構築する

1. 有効なプロファイルがプロファイルスイッチャーにリストされます。

アプリケーションを構築、実行、デバッグする前に、目的のプロファイルを選択してください。

![設定スイッチャーの cmake プロファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_profileSwitcher.png)

> **Note:**
> CLion は、選択したターゲットがそのプロファイルをサポートしているかどうかに基づいて、このスイッチャーで提案するプロファイルのリストをフィルタリングします。 例：
>
>
>
> Debug と Release という 2 つのプロファイルと、Debug のみでサポートされている  `debug_target`  というターゲットがあるとします。
>
>
>
>
> ```CMAKE
> if(${CMAKE_BUILD_TYPE} STREQUAL "Debug")
> add_executable(debug_target main.cpp)
> endif()
>
> ```
>
>
>
> [実行 / デバッグ構成](run-debug-configuration.html)でこのターゲットを選択した場合、CLion はデバッグプロファイルのみを提案します。

> **Note:**
> CMake プロファイルはプロジェクトのビルド方法を定義します。 デバッグセッション用のデバッガーを選択するには、同じツールバーにある独立したデバッグプロファイルスイッチャーから [デバッグプロファイル](debug-profiles.html)を選択してください。

2. ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.build.build.svg) をクリックするか、利用可能な [ビルドアクション](build-actions.html)のいずれかを呼び出します。

また、デフォルトでは、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) を実行する前、または ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) をデバッグする前にビルドが実行されます (これは構成設定で変更できます)。

Procedure: 新しいプロジェクトのデフォルトプロファイルを構成する

1. `ファイル | 新規プロジェクトのセットアップ | 新規プロジェクトの設定 | ビルド、実行、デプロイ | CMake`  に進みます。

2. デフォルトですべての [新しいプロジェクト](creating-new-project-from-scratch.html)に使用されるプロファイルのリストを構成します。

Procedure: プロファイルを共有する

プロジェクトと一緒に VCS で CMake プロファイルを共有できます。 プロファイルの設定は、  `.idea`  ディレクトリの  `cmake.xml`  に保存されます。

* 共有するプロファイルを選択し、   共有   チェックボックスを設定します。

![共有 CMake プロファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofile_shared.png)

共有プロファイルは自動的にリストの一番下に移動します。

> **Note:**
> プロファイリング   の設定のみ共有できます。   CMakeLists.txt または他の CMake 構成ファイルの編集時に CMake プロジェクトを再ロードする   オプションはすべてのプロファイルに共通であり、  `workspace.xml`  に保存されます。

共有プロファイルとローカルプロファイルには必ず異なる名前を付けてください。 共有プロファイルとローカルプロファイルの名前が同じである場合、ローカルプロファイルが優先され、設定に共有プロファイルは表示されません。

Procedure: プロファイルを無効 / 有効にする

現在使用されていないプロファイルを無効にして、ロードの時間を節約し、潜在的なエラーを回避できます（たとえば、定期的に使用しないリモートプロファイルがあり、マシンがシャットダウンされている場合）。

> **Note:**
> [プリセット](cmake-presets.html)プロファイルはデフォルトでは無効になっています。

> **Note:**
> プロファイルを有効または無効にすると、CLion は   CMakeLists.txt または他の CMake 構成ファイルの編集時に CMake プロジェクトを再ロードする   コントロールに関係なく CMake を段階的に再ロードします。
>
>
>
> CMake を再ロードすると、すべてのプロファイルが並行して再ロードされます。 一部の構成で問題が発生する可能性があります。 これを解決するには、  `設定 | 詳細設定 | CMake`  で   CMake プロファイルを順番に再ロードする   オプションを選択します。

次のいずれかのオプションを使用します。

* `設定 | ビルド、実行、デプロイ | CMake`  の   プロファイルを有効にする   チェックボックスをオフまたは設定します。 無効になっているプロファイルは、リストでグレー表示されます。

![無効なプロファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_disabledprofiles.png)

* 正常にロードされたプロファイルを無効にするには、   CMake   ツールウィンドウの設定メニューから   このプロファイルを無効にする   を選択します。

![CMake ツールウィンドウからロードされたプロファイルを無効にする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_disableprofile_fromtw.png)

このメニューから、無効になっているプロファイルを有効にすることもできます。

![CMake ツールウィンドウから無効なプロファイルを有効にする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofile_enable_fromtw.png)

## CMake のオプション

Procedure: コンパイラーフラグ

CLion では、プロファイルの   CMake のオプション   フィールドまたは  `CMakeLists.txt`  スクリプトでコンパイラーフラグを指定できます。

* CMake オプションの使用:

`設定 | ビルド、実行、デプロイ | CMake`  でプロファイルを選択し、   CMake のオプション   フィールドを編集します。

`-D`  と  `CMAKE_CXX_FLAGS`  変数を使用します（   C   プロジェクトの場合は  `CMAKE_C_FLAGS`  ）。 例:  `-DCMAKE_CXX_FLAGS="-Wall -Wextra"` 。

> **Note:**
> [キャッシュ変数](#cmake-cache-variables)テーブルの既存の CMake 変数の値を変更できます。

![CMake オプションでのコンパイラーフラグの設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_compilerlfags_cmakeoptions.png)

CLion は、   CMake のオプション   に渡された  `--preset`  引数でも機能します。 指定された [プリセット](cmake-presets.html)のデータは、ビルド型、ツールチェーン、ビルドディレクトリ設定に読み込まれます。

> **Tip:**
> 「 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 」をクリックして、プロジェクトのルートディレクトリマクロを挿入します。 詳細については、 [CMake 設定リファレンスページ](cmake0.html)を参照してください。

* また、 [CMakeLists.txt](cmakelists-txt-file.html) でコンパイラー フラグを設定することもできます。

必要なフラグを指定して次のコマンドを追加します。

```CMAKE
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra")
```

Procedure: CMake ツールチェーンファイル

* CMake のオプション   では、 [CMAKE_TOOLCHAIN_FILE(英語)](https://cmake.org/cmake/help/latest/variable/CMAKE_TOOLCHAIN_FILE.html) 変数を使用して CMake ツールチェーンファイルを指定できます。

## CMake キャッシュ変数

キャッシュ変数   テーブルの CMake キャッシュ変数を表示および編集できます。

![CMake キャッシュ変数](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_variables.png)

新しい変数は、 [CMake のオプション](#compiler-flags)フィールドまたは [CMakeLists.txt](cmakelists-txt-file.html) ファイルに追加できます。 ユーザー定義変数はテーブルの上部に配置されます。 ユーザー定義変数の値は太字でハイライトされ、他の変数の変更された値は斜体で表示されます。

![カスタム CMake 変数](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_custom_variables.png)

CMake のオプション   フィールドから変数を削除するには、テーブルで変数を選択して ![削除ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.popFrame.svg) をクリックするか、 `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS)) を押します。 [CMake キャッシュをリセットした](cmake-cache.html#reset-cache)後、変数がテーブルから削除されるか、その値がデフォルトに設定されます。

現在のセッションで行われた変更を破棄するには、変数を選択して ![「元に戻す」アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.diff.revert.svg) をクリックするか、 `Ctrl+Z` (Windows), `⌘ Z` (macOS), `⌘ Z` (IntelliJ IDEA Classic (macOS)), `⌘ Z` (macOS System Shortcuts), `Ctrl+Z` (XWin), `Ctrl+Z` (GNOME), `Ctrl+Z` (KDE), `Ctrl+Shift+Minus` (Emacs), `Ctrl+Z` (Sublime Text), `⌘ Z` (Sublime Text (macOS)), `⌘ Z` (Xcode), `Ctrl+Z` (Visual Studio), `⌘ Z` (Visual Studio (macOS)), `Ctrl+Z` (ReSharper), `⌘ Z` (ReSharper (macOS)), `Ctrl+Z` (QtCreator), `⌘ Z` (QtCreator (macOS)), `Ctrl+Z` (NetBeans), `Ctrl+Z` (Eclipse), `⌘ Z` (Eclipse (macOS)) を押します。

高度な CMake 変数はデフォルトで非表示になっていますが、   高度な表示   チェックボックスを選択することで表示できます。

![高度な CMake 変数を表示する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_variables_advanced.png)

CLion は、CMake キャッシング変数のツールチップにも簡単な説明を表示します：

![ツールチップ付きのブール変数](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_vars_boolean.png)

IDE では、ブール値がチェックボックスとして表示されます。 チェックボックスの横に、ブール変数の実際の値が表示されます。 次の値は  `False`  として扱われます:  `0`  、  `OFF`  、  `NO`  、  `N`  、  `IGNORE`  、  `NOTFOUND`  、空の文字列、接尾辞  `-NOTFOUND`  で終わる値。 その他の場合、値は  `True`  として扱われます。

CLion のユーザーインターフェースでチェックボックスをオンまたはオフにすると、次の値のペアがオプション値の構成に使用されます：  `0-1` 、  `OFF-ON` 、  `NO-YES` 、  `FALSE-TRUE` 、  `N-Y` 。 他の値の場合、IDE はチェックボックスの状態を  `OFF-ON` に変換します。

> **Note:**
> 名前付きブール定数は大文字と小文字を区別しません。

## ジェネレーター

生成プログラム   フィールドでは、 [CMake ジェネレーター(英語)](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html)を切り替えることができます。 選択したツールチェーンのデフォルト値を使用するか、事前定義されたリストから別のジェネレーターを設定します。

![カスタム CMake ジェネレーターの指定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofile_generators.png)

|    デフォルトを使用する    |     CLion は、デフォルトのジェネレーターとして [Ninja](https://ninja-build.org/) または Makefiles のいずれかを使用します。         Ninja   は、次の  すべて が当てはまる場合に使用されます。        * 選択した [ツールチェーン](how-to-create-toolchain-in-clion.html)はローカルです（ [リモート](remote-projects-support.html#remote-toolchain)、 [Docker](clion-toolchains-in-docker.html)、 [WSL](how-to-use-wsl-development-environment-in-product.html) は含まれません）。    * Ninja で選択したツールチェーン用に構成されたビルドツール（バンドルされた Ninja がデフォルトのビルドツールです）。    * CMake のバージョンは 3.20 以降です。    * プロジェクトは、CLion 2021.3 で初めて作成または開かれます。    * [詳細設定](advanced-settings.html)の CMake 3.20 以降にはレガシージェネレーターを使用する チェックボックスが設定されていません。      他のすべての場合、   Makefile   ジェネレーターが使用されます。     |
|    CMake に決めさせる    |  このオプションを選択した場合、CLion はジェネレーターを明示的に強制せず、CMake が使用するジェネレーターを決定します。 デフォルトでは、これは [CMAKE_GENERATOR(英語)](https://cmake.org/cmake/help/latest/envvar/CMAKE_GENERATOR.html#envvar:CMAKE_GENERATOR) 環境変数によって制御されます。  |

または、  `-G`  を介して   CMake のオプション   にジェネレーターを設定することもできます。   生成プログラム   フィールドが利用されている場合、CLion は   CMake のオプション   を自動的に更新し、その逆も同様です：

![CMake オプションの CMake ジェネレーター](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeprofiles_generator_options.png)

> **Note:**
> CMake プロファイル用の実際のビルドツールは、選択した [ツールチェーン](how-to-create-toolchain-in-clion.html)から取得されます。

### 現在の制限

* CLion は、CMake v3.14 で最初に登場した [CMake File API(英語)](https://cmake.org/cmake/help/v3.15/manual/cmake-file-api.7.html) を使用します。 ただし、CLion がサポートする最低限の CMake バージョンは 3.15 です。バンドルされている CMake から切り替える場合は、必ず バージョン 3.15.x 以上 を使用してください。

* Ninja Multi-Config、Xcode、Visual Studio などのマルチ構成ジェネレーターの場合、CLion は CMake プロファイル（ [CPP-20890](https://youtrack.jetbrains.com/issue/CPP-20890)）で指定された [ビルドタイプ](#buildtypes)に対応する構成のみを使用します。

## ビルドタイプ

ビルドタイプ   フィールドを使用して、次の [CMake ビルドタイプ(英語)](https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html)のいずれかを設定します。

* デフォルト（CMAKE_BUILD_TYPE の 空 の値に対応）。

* デバッグ (デフォルトのビルドタイプ)

* リリース

* RelWithDebInfo (デバッグ情報付きでリリース)

* MinSizeRel (サイズに最適化されたリリース)

`CMakeLists.txt`  のビルド型を参照するには、  `CMAKE_BUILD_TYPE`  変数を使用します。 例：

```CMAKE
if (CMAKE_BUILD_TYPE MATCHES Debug)
    add_definitions(-DDEBUG=1)
endif()
            
```

現在のビルドタイプに基づいて、コード内に条件ステートメントを作成することもできます。

```CPLUSPLUS
int main(int argc, const char* argv[]) {
#if DEBUG
...
#else
...
#endif

```

### カスタムビルドタイプ

利用可能なビルドタイプのリストは  `CMAKE_CONFIGURATION_TYPES`  コマンドで定義されています。 このコマンドのデフォルト値は上記の 4 つのビルドタイプですが、他のビルドタイプに拡張することができます。 例：

```CMAKE
# adding two custom build types to the cached value
# variable CMAKE_CONFIGURATION_TYPES should be defined before other definitions:
set(CMAKE_CONFIGURATION_TYPES "MyDebug;MyRelease" CACHE STRING "" FORCE)

```

プロジェクトを再ロードした後、CMake 設定からカスタムタイプが利用可能になります。

![カスタムビルドタイプ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_custom_buildtypes.png)

カスタムタイプは、  `CMakeCache.txt`  にキャッシュされた値  Debug に 追加されたことに注意してください。 たとえば、新しい CMake プロファイルを追加すると、独自の  `CMakeCache.txt`  が作成され、このプロファイルの場合、使用可能なビルドタイプのリストにはカスタムタイプのみが含まれます。

![新しい cmake プロファイルのカスタムビルドタイプ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_custom_buildtypes_profiles.png)

## ビルドオプション

ビルドオプション   フィールドでは、CMake が使用するビルドツールに渡すオプション、または CMake 自体のコマンドラインパラメーターとして渡すオプションを設定できます。 これらのオプションは、 [ビルド(英語)](https://cmake.org/cmake/help/latest/manual/cmake.1.html#build-a-project)フェーズで使用されます。

基礎となるビルドツール（make、Ninja、別のツール）の引数の前には  `--`  を付ける必要があります。 例:  `-j 5 --clean-first -- -d -p`  を指定すると、  `-j 5 --clean-first`  は CMake によって処理され、  `-d -p`  はビルドツールに渡されます。

このフィールドに何も指定されていない場合、CLion は選択された環境に依存するデフォルト設定を使用します。 例: 並列で実行されるビルドプロセスのデフォルト設定は、   make   および   Ninja   の場合  `-- -j max(cpucount * 0.8, cpucount - 2)`  ですが、 [Microsoft Visual C++](quick-tutorial-on-configuring-clion-on-windows.html#MSVC) の場合、このオプションは設定されておらず、フィールドは空です。

## 環境変数

追加の環境変数を CMake 世代に渡して、  `CMake の設定`  ダイアログの   環境   フィールド（  `設定 | ビルド、実行、デプロイ | CMake`  に移動）でビルドすることができます。

> **Note:**
> プロファイルで指定する環境変数は、CMake の生成とビルドに影響しますが、バイナリの起動には影響しません。

CMake の生成とビルドに影響を与える全体的な環境   は、次のもので構成されます。

* 親環境 親環境を含めるには、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineVariables.svg) をクリックするか `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⇧ ⏎` (Sublime Text (macOS)), `⇧ ⏎` (Xcode), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⇧ ⏎` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `⇧ ⏎` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS)) を押して 環境変数 ダイアログを開き、 システム環境変数を含める チェックボックスを設定します。 追加で指定した値は、システム変数に追加されます。 それ以外の場合、チェックボックスをオフにすると、カスタム値がシステムの値を上書きします。

* ツールチェーン環境 これらは、選択したツールセットによって定義された変数（たとえば、 [MSVC](quick-tutorial-on-configuring-clion-on-windows.html#MSVC) の場合は `vcvarsall.bat` 、または `mingw/bin` のようなパス変数）、 [環境初期化スクリプト](how-to-create-toolchain-in-clion.html#env-scripts)からの変数です。 > **Tip:** > [ツールチェーン環境スクリプト](how-to-create-toolchain-in-clion.html#env-scripts)を使用して、ファイルから CMake 変数を設定できます。

* CMake プロファイル環境 環境 フィールドで指定されたカスタム変数。

親の環境変数を含む既存の変数は、  `$VAR$`  構文を使って参照できます。 このような参照は大文字と小文字を区別します。例えば、Linux/macOS では  `PATH=xxx:$PATH$` 、Windows では  `Path=xxx;$Path$`  です。 既存の変数の参照は、 [リモートツールチェーン](remote-projects-support.html)（ [CPP-15693](https://youtrack.jetbrains.com/issue/CPP-15693)）では現在利用できません。

## See also

### リファレンス

[CMake Profile settings](cmake0.html)

### ハウツー

[CMakeLists.txt](cmakelists-txt-file.html) [CMake プロファイリング](cmake-profiling.html) [コンパイラー](how-to-switch-compilers-in-clion.html) [ツールチェーン](how-to-create-toolchain-in-clion.html) [ビルドアクション](build-actions.html) [実行 / デバッグ構成](run-debug-configuration.html)

