CLion 2026.2 Help

调试服务器

调试服务器让嵌入式开发的调试设置更简单。 使用预配置的调试服务器,您可以运行不同的运行/调试配置或构建系统目标,例如 CMake 或 Makefile。 您还可以运行长期运行的调试服务器会话,称为 GDB 目标扩展远程模式:停止调试时服务器不会关闭。

本指南解释了如何配置调试服务器并运行调试会话。 为了演示功能特性,我们使用 nRF52840 开发套件 ,该套件内置 SEGGER J-Link 调试器,并包含一个在控制台中输出“Hello world”的简单应用示例。

配置调试服务器

  1. 转到 设置 | 构建、执行、部署 | 调试器 | 调试配置文件},{

  2. 用于嵌入式开发的调试器 下,点击你的调试探针对应的磁贴。 CLion 会将该类型的调试服务器配置文件添加到列表中。

    添加调试服务器配置文件。

    GDB Server 磁贴适用于任何调试探针,并提供更广泛的选项。 其他类型更专注,仅提供必要选项: SEGGER J-Link 配置文件面向 J-Link 调试探针 ,而 ST-LINKESP-IDF 分别面向 STM32CubeMXESP-IDF 项目。

  3. 在适当的选项卡中配置 GDB 服务器、设备和调试器,以满足您的项目需求。

    一些重要的设置需要注意:

    • GDB Server 选项卡没有默认设置,因此您需要手动指定所有字段。

      配置通用调试服务器
    • 帮助 字段位于 GDB Server 选项卡中,允许您使用 --help 命令行参数运行 GDB 服务器,直接在此字段中查看输出并找到可用参数。 可以点击蓝色高亮显示的实参,它们会自动添加到 参数 字段中。 请注意,此选项仅适用于支持 --help 参数的 GDB 服务器。

    • 您还可以通过点击 测试运行… 检查 参数 字段旁边的参数有效性。

    • 设备设置 选项卡仅允许您指定控制台端口。 这意味着您不限于某种控制台类型,可以使用任何类型。 要配置控制台,请使用 GDB Server 选项卡中的 参数 字段。

    • 调试器 选项卡中, 持久会话 功能具有多个配置选项。 在 参数 字段中,您可以指定 TCP 主机、端口和其他命令行参数。 您还可以创建一个自定义连接脚本,在调试开始时运行。

      通用持久会话
  4. 完成调试服务器配置后,点击 确定。 调试服务器配置文件会出现在主工具栏的调试配置切换器中,可以开始调试。

使用 VCS 共享调试服务器

要通过如 Git 等版本控制系统共享调试服务器配置文件,请在配置文件设置中选择 共享 选项。 CLion 会将共享的配置文件存储在 .idea/debug-profiles.xml 文件中。 有关更多信息,请参阅 共享调试配置文件

    使用调试服务器进行调试

    1. 在源代码中设置断点。

    2. 从主工具栏的切换器中选择您的 运行 / 调试配置

      选择运行/调试配置
    3. 点击工具栏上的 开始调试会话。 调试器将连接到您的调试探针:

      选择运行/调试配置

    然后,您可以执行可用的调试器操作并分析所需数据。 要了解调试器工具窗口的更多功能,请参阅 其概述

    调试 工具窗口中,有一些专为嵌入式系统调试设计的选项。 例如,您可以重置您的 MCU:

    重置设备

    要查看调试服务器日志或控制台输出,请点击 显示服务 图标,该图标位于 调试 工具窗口或左侧的 服务 工具窗口图标中:

    切换到服务

    选择 GdbServer 选项卡:

    查看 GDB 服务器日志

    要查看控制台输出,请选择 MCU 控制台 选项卡:

    查看控制台输出

    为了更方便,您可以将 服务 工具窗口移动到右侧,以便同时使用调试器并查看例如控制台输出:

    移动服务选项卡
    2026年 7月 15日