# 调试服务器

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

> **TL;DR**
> 操作系统 ：Windows、Linux、macOS

> **Note:**
> 从 CLion 2026.2 开始，调试服务器将被配置为 [调试配置文件](debug-profiles.html)。 专用的  `调试服务器` 设置页面和  `启用调试服务器` 高级设置已被移除。

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

本指南解释了如何配置调试服务器并运行调试会话。 为了演示功能特性，我们使用 [nRF52840 开发套件](https://docs.nordicsemi.com/bundle/ug_nrf52840_dk/page/UG/dk/intro.html)，该套件内置 SEGGER J-Link 调试器，并包含一个在控制台中输出“Hello world”的简单应用示例。

> **Note:**
> 调试服务器配置文件目前尚不支持 PlatformIO（有 [变通方法](https://youtrack.jetbrains.com/issue/CPP-42014/Debug-Servers-are-not-compatible-with-PlatformIO?_gl=1*uzimb0*_gcl_au*NzYzNDk1NTkwLjE3MzQ0Mzk5MDg.*FPAU*NzYzNDk1NTkwLjE3MzQ0Mzk5MDg.*_ga*MTI3Mjg5MDAzNy4xNzI2NjYzMjMz*_ga_9J976DJZ68*MTczNDYwNzgyNS4yNzAuMS4xNzM0NjA5ODMzLjYwLjAuMA..)）、West 和 CTest。

Procedure: 配置调试服务器

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

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

![添加调试服务器配置文件。](https://resources.jetbrains.com/help/img/idea/2026.3/cl_configure_debug_server.png)

GDB Server   磁贴适用于任何调试探针，并提供更广泛的选项。 其他类型更专注，仅提供必要选项：   SEGGER J-Link   配置文件面向 [J-Link 调试探针](https://www.segger.com/products/debug-probes/j-link/)，而   ST-LINK   与   ESP-IDF   分别面向 [STM32CubeMX](embedded-stm32.html) 和 [ESP-IDF](esp-idf.html) 项目。

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

> **Tip:**
> 调试服务器模板提供一些可供使用的默认设置。 但是，某些设置可能需要或希望自定义。 请参考下方的   SEGGER J-Link   和   GDB Server   设置。

SEGGER J-Link:

请确保已安装 [J-Link 软件](https://www.segger.com/downloads/jlink/#J-LinkSoftwareAndDocumentationPack)。

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

* 在 SEGGER JLink GDB Server 选项卡中，您需要指定正在使用的设备： ![配置 SEGGER J-Link 调试服务器](https://resources.jetbrains.com/help/img/idea/2026.3/cl_configure_segger_j_link.png) CLion 会尝试通过可执行文件猜测安装路径，但有时需要手动输入路径。

* 在 设备设置 选项卡中，您可以选择并配置首选的控制台类型，例如 [RTT](https://kb.segger.com/RTT)、 [Semihosting](https://kb.segger.com/Semihosting) 或 [SWO](https://kb.segger.com/SWO)，以查看 `printf` 输出。 除了端口外，SWO 还有其他参数需要配置。 请确保您的 MCU 和固件已正确配置。 ![配置控制台](https://resources.jetbrains.com/help/img/idea/2026.3/cl_device_console_type.png)

* 调试器 选项卡具有一个 持久会话 选项。 此选项默认启用，即使会话关闭后也会保持与调试服务器的连接。 需要指定 GDB 服务器的端口。 ![J-Link 持久会话](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_servers_persistent.png) 持久会话在您希望调试服务器为下一次会话做好准备而无需等待其重新启动时非常有用。 如果您不需要此选项，可以取消选中。

GDB 服务器:

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

* GDB Server 选项卡没有默认设置，因此您需要手动指定所有字段。 ![配置通用调试服务器](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gdb_server_main_tab.png)

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

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

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

* 在 调试器 选项卡中， 持久会话 功能具有多个配置选项。 在 参数 字段中，您可以指定 TCP 主机、端口和其他命令行参数。 您还可以创建一个自定义连接脚本，在调试开始时运行。 ![通用持久会话](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_server_generic_persistent.png)

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

Procedure: 使用 VCS 共享调试服务器

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

Procedure: 使用调试服务器进行调试

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

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

![选择运行/调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_servers_run_config.png)

3. 点击工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) 开始调试会话。 调试器将连接到您的调试探针：

![选择运行/调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_server_connected.png)

然后，您可以执行可用的调试器操作并分析所需数据。 要了解调试器工具窗口的更多功能，请参阅 [其概述](debug-tool-window.html)。

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

![重置设备](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_server_reset.png)

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

![切换到服务](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_server_console.png)

选择   GdbServer   选项卡：

![查看 GDB 服务器日志](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_server_services.png)

要查看控制台输出，请选择   MCU 控制台   选项卡：

![查看控制台输出](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_server_console_tab.png)

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

![移动服务选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_servers_console_output.png)

## See also

### 相关内容

[Using live watches in the debugger](live-watches.html) [Working with STM32CubeMX projects](embedded-stm32.html) [Working with ESP-IDF projects](esp-idf.html)

