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

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

> **TL;DR**
> OS : macOS、Linux、Windows。
>
>
>
> 接続タイプ ：  `stdin` /  `stdout`  または TCP。
>
>
>
> ツールチェーン : ローカルのみ。 WSL、Remote、Docker はサポートされていません。

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

> **Tip:**
> この機能は CMSIS-DAP とは関係ありません。 CMSIS-DAP を使用するには、 [OpenOCD](openocd-support.html) を使用してください。 現在、OpenOCD 専用のデバッグサーバーは提供していませんが、代わりに [汎用](debug-servers.html#gdb-debug-server)のデバッグサーバーや OpenOCD 実行構成を使用することができます。

Procedure: DAP デバッガーを構成する

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

![Add Profile ポップアップから DAP デバッグプロファイルを追加している画面。DAP が最初に表示され、汎用デバッガーセクションにあります](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dap_add.png)

2. DAP デバッガーの名前、実行可能ファイルへのパス、引数、その他のパラメーターを指定します。 次に、   変更を適用   をクリックします。

![DAP デバッガー実行ファイルへのパスの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dap_add_configure.png)

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

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

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

* 実行中のプロセスにアタッチすると、IDE は常に `接続` リクエストを送信します。 ツールバーの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.png) アイコンをクリックしてデバッガーでプログラムを実行すると、IDE は `起動` リクエストを送信します。 ほとんどの DAP デバッガーは、指定された実行可能ファイルでデバッグセッションを開始するために `起動` リクエストを必要とします。 ただし、デバッガーが代わりに `接続` リクエストを必要とする場合は、デバッグセッションの開始時にそのリクエストを送信するように IDE を設定できます。

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

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

![ツールチェーンで DAP デバッガーを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dap_toolbar.png)

標準の [デバッガーアクション](starting-the-debugger-session.html)を実行できるようになりました。

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

DAP デバッガーが起動しない、または予期しない動作をする場合は、 [デバッガーログ](configuring-debugger-options.html#enable-debugger-logging)を有効化して問題を再現します。  `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`  を報告するステップが、ハンドシェイクが失敗した箇所です。

## See also

### コンセプト

[デバッグプロファイル](debug-profiles.html) [デバッグサーバー](debug-servers.html)

