# 多线程 RTOS 调试

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

在使用 RTOS 调试的情况下，CLion 提供了 [FreeRTOS](https://www.freertos.org/)、 [Azure RTOS](https://azure.microsoft.com/en-us/products/rtos/) 和 [Zephyr](https://zephyrproject.org/) 任务（线程）的视图。 对于 FreeRTOS，您还可以探索 [对象](#rtos-objects) 和 [堆](#rtos-heap)。

> **Tip:**
> 某些  gdbservers  内置支持不同的 RTOS。 为了使 CLion 集成在这种情况下正常工作，请确保在 gdbserver 端禁用内置支持。

Procedure: 启用 RTOS 线程视图

1. 转到  `设置 | 构建、执行、部署 | 嵌入式开发 | RTOS 集成` 。

2. 选中   启用 RTOS 集成   复选框并从选项列表中选择：

![启用 RTOS 集成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_integration_enable.png)

> **Note:**
> 请注意，RTOS 集成需要支持 Python 的 GDB 7.4 或更高版本。 您可以使用 CLion 自带的 GDB，参考 [切换调试器](configuring-debugger-options.html#select-debugger)。

RTOS 集成旨在适用于任何相关的 [运行/调试配置](run-debug-configuration.html)，例如 [嵌入式 GDB 服务器](embedded-gdb-server.html) 或 [OpenOCD 下载与运行](openocd-support.html#opecocd-debug)。

例如，以下是如何使用 [QEMU](https://www.qemu.org/) 模拟器设置嵌入式 GDB 服务器配置：

![嵌入式 GDB 服务器配置示例](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_qemu_config.png)

## FreeRTOS / Azure RTOS / Zephyr 任务视图

在调试如上所述的配置时，您将在   线程与变量   面板的 [调试工具窗口](debug-tool-window.html) 中看到 FreeRTOS / Azure RTOS / Zephyr 任务的列表。

![FreeRTOS 线程视图](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_debug_threadview.png)

对于每个任务，变量会显示在   变量   面板中。

RTOS 任务视图也适用于 [对称多处理 (SMP)](https://en.wikipedia.org/wiki/Symmetric_multiprocessing)。 处理器核心必须相同并共享相同的内存。

> **Note:**
> 如果您正在使用 Zephyr，请确保在项目配置文件中设置  `CONFIG_THREAD_MONITOR`  和  `CONFIG_THREAD_NAME` ，否则调试器将无法提取所需信息。 如果缺少定义，CLion 将通知您：
>
> ![缺少 Zephyr 配置参数](https://resources.jetbrains.com/help/img/idea/2026.3/cl_zephyr_notification.png)

## FreeRTOS 对象视图

要探索 FreeRTOS 对象，请切换到   FreeRTOS 对象   选项卡。  任务  表显示了带有状态信息的任务列表；  队列  表显示了当前活动的队列、信号量和互斥量；  定时器  表列出了软件定时器：

![FreeRTOS 对象视图](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_objectsview.png)

要使此选项卡正常工作，请在  `FreeRTOSConfig.h`  中配置以下定义：

* 将 `configUSE_TRACE_FACILITY` 设置为 1，以显示任务编号和队列类型。

* 将 `configMAX_TASK_NAME_LEN` 设置为大于零的值，以正确显示任务名称。

* 将 `configRECORD_STACK_HIGH_ADDRESS` 设置为 1，以显示任务堆栈信息。

* 将 `configUSE_TRACE_FACILITY` 和 `configGENERATE_RUN_TIME_STATS` 设置为 1，以收集运行时信息（任务表的运行时列）。

* 使用大于零的 `configQUEUE_REGISTRY_SIZE` 和 `vQueueAddToRegistry()` 为队列、信号量或互斥量分配名称。 这很有用，因为队列默认没有名称，而任务在创建时会获得名称。

如果缺少某些定义，CLion 将显示警告：

![缺少 FreeRTOS 定义](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_defines_warning.png)

## FreeRTOS 堆视图

FreeRTOS 堆   选项卡显示所有默认 FreeRTOS 内存管理方案的当前堆使用情况和内存块分配。

> **Note:**
> 为了正确支持 [heap_5](https://www.freertos.org/a00111.html)，请确保在全局作用域内定义  `xHeapRegions`  变量，例如：
>
>
> ```CPLUSPLUS
> HeapRegion_t xHeapRegions[] = {
> { &heap_sram_lower1[0], sizeof(heap_sram_lower1)},
> { &heap_sram_lower2[0], sizeof(heap_sram_lower2)},
> {NULL, 0}
> };
> int main( void ) {...}
>
> ```

![FreeRTOS 堆视图](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_heapview.png)

## See also

### 流程

[嵌入式开发](embedded-overview.html) [嵌入式 GDB 服务器](embedded-gdb-server.html) [OpenOCD 支持](openocd-support.html) [调试](debugging-code.html)

### 操作指南

[设备树文件](dts-support.html) [链接脚本](language-support-for-linker-scripts.html)

