llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

デバッグアダプタープロトコル

CLion は、LLDB と GDB に加え、 デバッグアダプタープロトコル (DAP)(英語) をサポートするサードパーティ製デバッガーとも連携できます。 DAP テクノロジーにより、CLion は標準化されたインターフェースを介して様々なデバッガー実装と連携できます。 最終的に、CLion の DAP サポートは、このプロトコルをサポートする LLDB/GDB 以外の新しいデバッガーを使用する際に、一貫したデバッグエクスペリエンスを提供します。

DAP デバッガーを構成する

  1. 設定 | ビルド、実行、デプロイ | デバッガー | デバッグプロファイル に移動し、 + をクリックして新しい DAP プロファイリング プロファイルまたは 汎用デバッガー セクションの該当アイコンを追加します。

    Add Profile ポップアップから DAP デバッグプロファイルを追加している画面。DAP が最初に表示され、汎用デバッガーセクションにあります
  2. DAP デバッガーの名前、実行可能ファイルへのパス、引数、その他のパラメーターを指定します。 次に、 変更を適用 をクリックします。

    DAP デバッガー実行ファイルへのパスの追加

    標準入出力(stdin/stdout )による通信、または TCP による通信のいずれかを選択できます。 TCP が選択されている場合は、接続先のポートを指定する必要があります。

    DAP デバッガーを設定する際は、以下の点に留意してください。

    • $DebuggerPort$ マクロは、DAP 実行コマンドのコマンドライン引数や 起動/パラメーターを添付する などのさまざまなフィールドで使用して、 ポート フィールドで指定された TCP ポート番号を挿入できます。

    • 実行中のプロセスにアタッチすると、IDE は常に 接続 リクエストを送信します。 ツールバーの アイコンをクリックしてデバッガーでプログラムを実行すると、IDE は 起動 リクエストを送信します。 ほとんどの DAP デバッガーは、指定された実行可能ファイルでデバッグセッションを開始するために 起動 リクエストを必要とします。 ただし、デバッガーが代わりに 接続 リクエストを必要とする場合は、デバッグセッションの開始時にそのリクエストを送信するように IDE を設定できます。

    • 起動パラメーター と パラメーターを添付する はデバッガー固有のものです。 CLion は、GDB と LLDB の両方で機能する適切なデフォルト値をあらかじめ設定しています。 ただし、使用する JSON パラメーターを確認するには、ご使用のデバッガーのドキュメントを参照することをお勧めします。 CLion は現在、 起動パラメーター の $Executable$、 $WorkingDir$、 $Arguments$、 $Environment$、 $EnvironmentArray$ マクロと パラメーターを添付する の $Pid$ マクロをサポートしています。 コード補完は利用可能なマクロに対応しており、その意味を表示します。

  3. メインツールバーで DAP デバッガーを選択します。

    ツールチェーンで DAP デバッガーを選択する

標準の デバッガーアクションを実行できるようになりました。

DAP デバッガーのトラブルシューティング

DAP デバッガーが起動しない、または予期しない動作をする場合は、 デバッガーログを有効化して問題を再現します。 com.jetbrains.cidr.execution.debugger カテゴリをオンにすると、 idea.log はアダプターと交換されるすべての DAP リクエスト、レスポンス、イベントを記録します。 ログでは、これらのエントリは FINE - #c.j.c.e.debugger として表示され、送信メッセージには out: 、受信メッセージには in: というプレフィックスが付きます:

2026-08-18 15:21:12,358 [1154106] FINE - #c.j.c.e.debugger - out: { "type": "request", "command": "initialize", ... } 2026-08-18 15:21:12,643 [1154391] FINE - #c.j.c.e.debugger - in: { "type": "response", "command": "initialize", "success": true, ... } 2026-08-18 15:21:12,659 [1154407] FINE - #c.j.c.e.debugger - out: { "type": "request", "command": "launch", ... } 2026-08-18 15:21:12,726 [1154474] FINE - #c.j.c.e.debugger - in: { "type": "response", "command": "launch", "success": true } 2026-08-18 15:21:12,726 [1154474] FINE - #c.j.c.e.debugger - in: { "type": "event", "event": "initialized" }

アダプターを起動できない、または接続できない場合、CLion は IDE で DAP サーバーの初期化に失敗しました エラーを報告します。 原因は通信内容にあります: 正常な起動と比較してください。正常な起動には、 initialize へのレスポンス、 launch または attach へのレスポンス、 initialized イベント、および configurationDone へのレスポンスが含まれます。 欠落しているステップ、または "success": false を報告するステップが、ハンドシェイクが失敗した箇所です。

2026 年 11 月 6 日