CLion 2026.2 Help

デバッグプロファイル

デバッグプロファイルは、CLion がアプリケーションをデバッグする方法、つまりどのデバッガーを使用しどう設定するかを定義します。 プロファイルは再利用可能で ツールチェーンと独立しているため、プロジェクトのビルド方法を変更せずにデバッガーを変更できます。

各デバッグプロファイルは、CMake プロファイルや実行/デバッグ構成とは別個です:

  • CMake プロファイル (およびそのツールチェーン)はプロジェクトのビルド方法を定義します。

  • 実行/デバッグ構成は、実行する内容(ターゲット、プログラム引数、環境)を定義します。

  • デバッグプロファイルは、どのようにデバッグするか(デバッガーとそのオプション)を定義します。

メインツールバーでアクティブな CMake プロファイルとデバッグプロファイルを個別に選択できるため、どんなビルドと互換性のあるデバッガーでもペアにできます。

CLion のツールバーのプロファイルスイッチャーが開いており、CMake プロファイルは Debug、Debug プロファイルはアクティブな LLDB プロファイルに設定されています。

デバッグプロファイルタイプ

CLion は利用可能なデバッガータイプを二つのカテゴリに分類します。

汎用デバッガー:

組み込み開発用のデバッガー:

  • GDB サーバー(汎用 gdbserver(ジーディービーサーバー) プロファイル)

  • SEGGER J-Link

  • STM32CubeMX プロジェクト用の ST-LINK

  • ESP-IDF プロジェクト用の ESP-IDF

Apple Silicon 搭載の macOS では、Rosetta GDB プロファイルも aarch64 ホストで x86 ターゲットのデバッグ用として利用できます。

デバッグプロファイル設定を開く

設定 | ビルド、実行、デプロイ | デバッガー | デバッグプロファイル に進みます。

GDB プロファイルが一覧表示されている Debug Profiles の設定ページ。組み込み用と汎用デバッガープロファイルを作成するタイルがあります。

左側のリストには、既存のプロファイリングが表示されます。 右側のタイルで、選択したタイプの新しいプロファイリングを作成します。 CLion はプラットフォームに最適なデフォルトプロファイリングを検出するため、初回実行時でもリストは空になりません。例えば、Linux では GDB プロファイリング、macOS では LLDB プロファイリングが表示されます。

デバッグプロファイルを作成

  1. 汎用デバッガー または 組み込み開発用デバッガー の下から、必要なデバッガータイプのタイルをクリックしてください。 CLion がそのタイプの新しいプロファイリングをリストに追加します。

    組み込みデバッガー ESP-IDF、SEGGER J-Link、ST-LINK、GDB サーバー、および汎用 DAP、GDB、LLDB 用のデバッグプロファイル作成タイル。
  2. プロファイリングのフィールドを設定し、 OK をクリックします。

汎用プロファイルの設定

GDB または LLDB プロファイリングでは、以下のフィールドが表示されます:

CLion の Debug Profiles 設定で、GDB プロファイルの Name、Executable、Advanced フィールドとストレージオプションが表示されています。
命名方法名

リストおよびツールバースイッチャーで表示されるプロファイリング名です。

実行可能ファイル

デバッガーバイナリへのパス。 このフィールドを空欄のままにすると、利用可能であればバンドルされた GDB または LLDB、もしくは PATH からデバッガーが使用されます。 リモート、Docker、WSL ツールチェーンの場合、CLion はその環境からデバッガーを解決します。

拡張

デバッグセッションに適用されるタイプ固有のオプション。 DAP プロファイリングの場合、 起動 や 接続 タブでアダプター構成を JSON で指定します。

アクティブなデバッグプロファイルを選択

メインツールバーのデバッグプロファイリングスイッチャーからアクティブなプロファイリングを選択します。 スイッチャーには現在のプロファイリングが デバッグ|<profile> として表示され、実行/デバッグ構成選択の隣に配置されます。

CLion のツールバーのプロファイルスイッチャーが開いており、CMake プロファイルは Debug、Debug プロファイルはアクティブな LLDB プロファイルに設定されています。

プロジェクトに CMake プロファイリングがいくつかある場合、スイッチャーには CMake プロファイリング用のグループとデバッグプロファイリング用のグループが個別に表示されます。 各グループからプロファイリングを 1 つ選択します。CMake プロファイリングはビルドを、デバッグプロファイリングはデバッガーを定義します。 各グループには対応する設定ページへのリンクも用意されています。

デバッグプロファイリングは、 で次に開始するデバッグセッションで適用されます。 でアプリケーションを実行する場合、デバッグプロファイリングは不要です。

デバッグプロファイルを共有

デフォルトでは、プロファイリングはプロジェクト内に保存されます。 プロファイリング設定のオプション すべてのプロジェクトで利用可能 と 共有 で、プロファイリングの保存先を変更できます。

GDB デバッグプロファイルで「すべてのプロジェクトで利用可能」がクリアされ、「共有」が選択されてプロファイルがバージョン管理に保存されています。
すべてのプロジェクトで利用可能

プロファイリングを IDE 設定に保存して、開いたすべてのプロジェクトで利用できるようにします。

共有

プロファイリングを .idea/debug-profiles.xml ファイルに保存し、 バージョン管理にコミットしてチームで共有できます。

これらのオプションは同時に 1 つしか利用できません。 すべてのプロジェクトで利用可能 がクリアされている時のみ 共有 が利用可能です。

サポートされている実行 / デバッグ構成

デバッグプロファイリングは、以下の実行/デバッグ構成で利用できます:

プロセスへアタッチすると、ダイアログには選択したホストと互換性のあるデバッグプロファイリングが表示されます。

以前のバージョンからの移行

CLion 2026.1 以前で作成されたプロジェクトを開くと、CLion が既存のデバッガー設定を一度だけデバッグプロファイリングに変換します。変換の対象は: 変換の対象は:

  • ツールチェーンに設定されたデバッガーと DAP デバッガーは、すべてのプロジェクトで利用可能なプロファイリングとして変換されます。

  • リモートデバッグやコアダンプデバッグ構成で使われたカスタムデバッガーは、プロジェクトプロファイリングとして変換されます。

  • 構成済みのデバッグサーバーは、プロジェクトプロファイリングに変換されます。

変換は初回プロジェクトオープン時だけ行われ、以降は繰り返されません。そのため追加設定なしでプロファイリングがすぐ利用可能となります。

ツールチェーンに設定されたデバッガー

設定 | ビルド、実行、デプロイ | ツールチェーン にある デバッガー​ フィールドは、デバッグプロファイリングが推奨されるため非推奨となりました。

CLion のツールチェーン設定で、ツールチェーンのデバッガーフィールドが Debug Profiles 優先で非推奨になっている通知が表示されています。

デバッグセッションを開始すると、CLion はツールチェーンデバッガーではなく選択したデバッグプロファイリングを使用します。

2026 年 8 月 5 日