CLion 2026.2 Help

CMake プリセット

CMake プリセット(英語)は、次の 2 つのファイルを使用して CMake オプションを構成および共有する方法です。

  • プロジェクトごとのビルド用の CMakePresets.json 。 このファイルは VCS 経由で共有できます。

  • 開発者自身のローカルビルド用の CMakeUserPresets.json 。 このファイルは VCS にチェックインしないでください。

CMakePresets.json CMakeUserPresets.json はどちらも同じ形式であり、プロジェクトのルートディレクトリに配置する必要があります。

CMake プロファイル は CMake プリセットと多くの設定を共有しており、VCS を通じて共有することもできます。 主な違いは、プロファイルが CLion の ツールチェーンを参照し、その中には CMake プリセットに存在せず必要もない情報(デバッガーや環境設定など)が含まれている点です。

プリセットのインポート

プロジェクトを開くと、CLion はプロジェクトルートにある CMakePresets.json および CMakeUserPresets.json ファイル内のすべての ビルドおよび 構成プリセットを検出します。 デフォルトでは、それらはすべて読み取り専用モードで CMake プロファイル に自動的にロードされます。

ロードされたプリセットを表示するには、 設定 | ビルド、実行、デプロイ | CMake に移動するか、通知ダイアログの 表示 リンクを使用します。

プリセットロード通知
  • これまでにロードして有効化していない限り、すべての新しいプリセットはデフォルトで無効化されています(CLion は名前で一致させます)。

  • 以前にロードされたプリセットはすべて、 CMakePresets.json または CMakeUserPresets.json ファイルに存在しない場合は削除されます。

プリセットプロファイルの初期状態

プリセットを手動でロードする

すでに開いているプロジェクトのプリセットをロードすることもできます。

  1. ヘルプ | アクションの検索Ctrl+Shift+A )を呼び出し、 CMake プリセットをロードするを検索します。

  2. CLion は、既存のビルドプリセットのリストを含むポップアップを表示します:

    CMake プリセットのロードポップアップ
  3. プリセットを選択し、 Enter を押します。

    Ctrl または Shift を押し続けると、複数のエントリを選択できます。 CLion は、選択したすべてのプリセットをロードします。

  4. プロジェクトを開く場合と同様に、手動でロードしたプリセットは、読み取り専用モードで CMake プロファイルにインポートされます。 設定 | ビルド、実行、デプロイ | CMake で見つけることができます。

プリセットプロファイルを有効にする

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

  2. 目的のプロファイルを選択し、 プロファイルを有効にする チェックボックスを設定します。

    プリセットプロファイルの有効化

プリセットの編集

インポートしたプリセットを編集するために使用できるオプションは 2 つあります。

プリセットベースの CMake プロファイルのコピーを編集する

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

  2. 目的のプロファイルを選択し、 をクリックするか Ctrl/⌘ + D を押してください:

    プリセットベースのプロファイルのコピー
  3. コピーしたプロファイルの設定を調整します:

    コピーされたプリセットベースのプロファイルの編集

エディターで対応する JSON ファイルを変更する

  • 対応する json ファイルを開いて編集を開始します。 CLion は入力中の変更をトラックし、問題ビューでエラーについて通知します:

    CMake プリセットエラーレポート
  • エディターでプリセットファイルを変更したり外部で変更した場合、変更の再読み込みを提案する通知が表示されます:

    CMake プリセット JSOn ファイルの編集
  • CLion で変更をサイレントに再読み込みしたい場合は、 自動再ロードの有効化 をクリックします。 これにより、プロファイル設定の対応するチェックボックスが設定されます:

    CMake プロファイルの自動再ロード

ツールチェーンの変更

デフォルトでは、ロードされたプリセットはデフォルトの CLion ツールチェーン にリンクされます。

構成済みのツールチェーンの 1 つを設定するには、 configure プリセットのベンダー固有のフィールドを変更します。

例: 次のコードを使用して、Clang10 というツールチェーンに切り替えます。

"vendor": { "jetbrains.com/clion": { "toolchain": "Clang10" } }

その結果、Clang10 ツールチェーンがロードされたプリセットに割り当てられます。

ロードされた CMake プリセット

Windows では、 MSVC ツールチェーンを使用している場合、 configure プリセットのアーキテクチャとツールセットのプロパティが CMake オプションにもフェッチされます。

CMake プリセット MSVC オプション

条件サポート

CLion は、プリセットをフィルタリングするために、 CMakePresets.json および CMakeUserPresets.json ファイルの condition フィールドをサポートしています。 サポートされているのは equals および notEquals タイプのみであることに注意してください。

プリセットをプラットフォーム別にフィルタリングする方法の例を次に示します。

{ "name": "windows-only", "inherits": "default", "displayName": "Windows-only configuration", "description": "This build is only available on Windows", "condition": { "type": "equals", "lhs": "${hostSystemName}", "rhs": "Windows" } }

プラットフォームによるフィルタリングを構成すると、対応するプリセットは、それが有効になっているプラットフォームの プリセットプロファイルリストにのみ表示されます。

CMake のドキュメント(英語)condition フィールドオプションの詳細について説明します。

Python 統合

プロジェクトに Python インタープリターが設定されている場合は、CMake プリセットに渡すこともできます。 この場合、プリセット属性に enablePythonIntegration フラグを明示的に設定する必要があります。 次に例を示します。

... "configurePresets": [ { "name": "default", "vendor": { "jetbrains.com/clion": { "toolchain": "Default", "enablePythonIntegration": true } } } ], ...

vendor フィールドが設定されると、Python インタープリターが適切な CMake プロファイルに渡されます。

2026 年 7 月 15 日