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

CLion 2026.3 Help

调试适配器协议

除了 LLDB 和 GDB,CLion 还可以与支持 调试适配器协议 (DAP) 的第三方调试器配合使用。 DAP 技术使 CLion 能够通过标准化接口与各种调试器实现进行交互。 CLion 对 DAP 的支持可在使用新型的、非 LLDB/GDB 的支持该协议的调试器时,提供一致的调试体验。

配置 DAP 调试器

  1. 转到 设置 | 构建、执行、部署 | 调试器 | 调试配置文件},{ ,然后点击 + 以添加新的 DAP 分析配置文件,或在 通用调试器 部分点击相应图标。

    从“添加配置文件”弹出窗口添加 DAP 调试配置文件,其中 DAP 列在首位,并位于通用调试器部分
  2. 请指定 DAP 调试器的名称、可执行文件路径、参数及其他参数。 然后,点击 Apply。

    添加 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日