# 调试适配器协议

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

> **TL;DR**
> 操作系统 ：macOS、Linux、Windows。
>
>
>
> 连接类型 ：  `stdin` /  `stdout`  或 TCP。
>
>
>
> 工具链 ：仅限本地。 不支持 WSL、Remote 和 Docker。

除了 LLDB 和 GDB，CLion 还可以与支持 [调试适配器协议 (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 分析配置文件，或在  `通用调试器`  部分点击相应图标。

![从“添加配置文件”弹出窗口添加 DAP 调试配置文件，其中 DAP 列在首位，并位于通用调试器部分](https://resources.jetbrains.com/help/img/idea/2026.3/cl_dap_add.png)

2. 请指定 DAP 调试器的名称、可执行文件路径、参数及其他参数。 然后，点击   Apply  。

![添加 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)

