在使用freeRTOS做多任务的时候总是担心任务会出现Bug导致任务死机或其他异常情况这些很多都是由于堆栈分配不合理出现的问题那就要了解每个任务的堆栈使用情况。FreeRTOS 本身提供了专门的 API 来监控堆栈使用核心思路是通过查询任务控制块TCB中的堆栈信息计算已使用的堆栈空间。下面我会分步骤讲解具体实现方法。一、核心 API 介绍FreeRTOS 提供了两个关键函数来获取堆栈信息uxTaskGetStackHighWaterMark()获取任务堆栈的 “高水位线”即任务运行至今堆栈剩余空间的最小值返回值是剩余的堆栈字数32 位系统中 1 个字 4 字节。vTaskList()生成一个包含所有任务状态、优先级、堆栈使用等信息的文本列表需要开启宏配置。二、基础配置必须首先需要在FreeRTOSConfig.h中开启相关宏否则 API 无法使用/* 开启堆栈高水位线检测 */ #define configUSE_TRACE_FACILITY 1 #define configUSE_STATS_FORMATTING_FUNCTIONS 1 // 配合vTaskList使用 #define configGENERATE_RUN_TIME_STATS 0 // 非必需若仅看堆栈可设0三、具体实现方法方法 1单个任务堆栈查询最常用适用于针对性查看某个任务的堆栈使用情况示例代码如下#include FreeRTOS.h #include task.h // 定义任务句柄创建任务时保存 TaskHandle_t xTestTaskHandle NULL; // 测试任务函数 void vTestTask(void *pvParameters) { for(;;) { // 任务业务逻辑 vTaskDelay(pdMS_TO_TICKS(1000)); } } // 查看堆栈使用的函数可在主任务/调试任务中调用 void vCheckStackUsage(void) { // 1. 获取当前任务的堆栈高水位线 UBaseType_t uxCurrentTaskStack uxTaskGetStackHighWaterMark(NULL); // 2. 获取指定任务的堆栈高水位线需传入任务句柄 UBaseType_t uxTestTaskStack uxTaskGetStackHighWaterMark(xTestTaskHandle); // 3. 计算堆栈使用情况假设创建任务时分配了1024字的堆栈 const UBaseType_t uxTestTaskStackSize 1024; UBaseType_t uxUsedStack uxTestTaskStackSize - uxTestTaskStack; float fStackUsage (float)uxUsedStack / uxTestTaskStackSize * 100; // 打印结果需实现串口打印函数如printf printf(当前任务剩余堆栈%lu 字\r\n, uxCurrentTaskStack); printf(测试任务剩余堆栈%lu 字已使用%.1f%%\r\n, uxTestTaskStack, fStackUsage); } // 任务创建示例 void vCreateTasks(void) { xTaskCreate(vTestTask, // 任务函数 TestTask, // 任务名 1024, // 堆栈大小字 NULL, // 参数 tskIDLE_PRIORITY 1,// 优先级 xTestTaskHandle); // 任务句柄 }方法 2批量查看所有任务堆栈vTaskList适用于全局监控所有任务的状态示例代码#include FreeRTOS.h #include task.h #include stdio.h // 缓冲区需足够大建议至少1024字节 static char pcWriteBuffer[1024]; void vPrintAllTaskStack(void) { // 获取所有任务信息并写入缓冲区 vTaskList(pcWriteBuffer); // 打印任务列表格式任务名 状态 优先级 剩余堆栈 任务编号 printf(任务名\t状态\t优先级\t剩余堆栈\t任务编号\r\n); printf(----------------------------------------------------\r\n); printf(%s\r\n, pcWriteBuffer); }输出示例任务名 状态 优先级 剩余堆栈 任务编号----------------------------------------------------IDLE R 0 120 1TestTask B 1 896 2UARTTask B 2 512 3状态说明R(运行)、B(阻塞)、S(挂起)、D(删除)。四、关键注意事项堆栈单位FreeRTOS 中堆栈大小以 “字” 为单位32 位 CPU4 字节 / 字例如配置 1024 字 4096 字节。高水位线意义剩余堆栈最小值越小说明任务运行时堆栈越接近溢出建议保留至少 20% 的余量。API 调用上下文uxTaskGetStackHighWaterMark()可在任务中调用传 NULL 查当前任务也可在中断外查其他任务。vTaskList()不能在中断中调用且会暂时关闭调度器建议在低优先级任务中调用。栈溢出检测除了主动查询还可开启configCHECK_FOR_STACK_OVERFLOW1 或 2让 FreeRTOS 在检测到栈溢出时调用钩子函数vApplicationStackOverflowHook()。总结查看 FreeRTOS 堆栈的核心是使用uxTaskGetStackHighWaterMark()单任务或vTaskList()全任务需先开启configUSE_TRACE_FACILITY宏。堆栈高水位线是判断栈溢出风险的关键指标剩余值越小风险越高。批量查看任务列表时vTaskList()输出的 “剩余堆栈” 即为该任务的高水位线值可直接反映堆栈使用情况。通过以上方法你可以精准监控每个任务的堆栈使用避免栈溢出问题同时优化内存分配。 
长河君 · 2026/10/9 1:48:07 · 阅读 1.2k FreeRtos——15、查看freeRTOS堆栈使用情况——非常重要
在使用freeRTOS做多任务的时候总是担心任务会出现Bug导致任务死机或其他异常情况这些很多都是由于堆栈分配不合理出现的问题那就要了解每个任务的堆栈使用情况。FreeRTOS 本身提供了专门的 API 来监控堆栈使用核心思路是通过查询任务控制块TCB中的堆栈信息计算已使用的堆栈空间。下面我会分步骤讲解具体实现方法。一、核心 API 介绍FreeRTOS 提供了两个关键函数来获取堆栈信息uxTaskGetStackHighWaterMark()获取任务堆栈的 “高水位线”即任务运行至今堆栈剩余空间的最小值返回值是剩余的堆栈字数32 位系统中 1 个字 4 字节。vTaskList()生成一个包含所有任务状态、优先级、堆栈使用等信息的文本列表需要开启宏配置。二、基础配置必须首先需要在FreeRTOSConfig.h中开启相关宏否则 API 无法使用/* 开启堆栈高水位线检测 */ #define configUSE_TRACE_FACILITY 1 #define configUSE_STATS_FORMATTING_FUNCTIONS 1 // 配合vTaskList使用 #define configGENERATE_RUN_TIME_STATS 0 // 非必需若仅看堆栈可设0三、具体实现方法方法 1单个任务堆栈查询最常用适用于针对性查看某个任务的堆栈使用情况示例代码如下#include FreeRTOS.h #include task.h // 定义任务句柄创建任务时保存 TaskHandle_t xTestTaskHandle NULL; // 测试任务函数 void vTestTask(void *pvParameters) { for(;;) { // 任务业务逻辑 vTaskDelay(pdMS_TO_TICKS(1000)); } } // 查看堆栈使用的函数可在主任务/调试任务中调用 void vCheckStackUsage(void) { // 1. 获取当前任务的堆栈高水位线 UBaseType_t uxCurrentTaskStack uxTaskGetStackHighWaterMark(NULL); // 2. 获取指定任务的堆栈高水位线需传入任务句柄 UBaseType_t uxTestTaskStack uxTaskGetStackHighWaterMark(xTestTaskHandle); // 3. 计算堆栈使用情况假设创建任务时分配了1024字的堆栈 const UBaseType_t uxTestTaskStackSize 1024; UBaseType_t uxUsedStack uxTestTaskStackSize - uxTestTaskStack; float fStackUsage (float)uxUsedStack / uxTestTaskStackSize * 100; // 打印结果需实现串口打印函数如printf printf(当前任务剩余堆栈%lu 字\r\n, uxCurrentTaskStack); printf(测试任务剩余堆栈%lu 字已使用%.1f%%\r\n, uxTestTaskStack, fStackUsage); } // 任务创建示例 void vCreateTasks(void) { xTaskCreate(vTestTask, // 任务函数 TestTask, // 任务名 1024, // 堆栈大小字 NULL, // 参数 tskIDLE_PRIORITY 1,// 优先级 xTestTaskHandle); // 任务句柄 }方法 2批量查看所有任务堆栈vTaskList适用于全局监控所有任务的状态示例代码#include FreeRTOS.h #include task.h #include stdio.h // 缓冲区需足够大建议至少1024字节 static char pcWriteBuffer[1024]; void vPrintAllTaskStack(void) { // 获取所有任务信息并写入缓冲区 vTaskList(pcWriteBuffer); // 打印任务列表格式任务名 状态 优先级 剩余堆栈 任务编号 printf(任务名\t状态\t优先级\t剩余堆栈\t任务编号\r\n); printf(----------------------------------------------------\r\n); printf(%s\r\n, pcWriteBuffer); }输出示例任务名 状态 优先级 剩余堆栈 任务编号----------------------------------------------------IDLE R 0 120 1TestTask B 1 896 2UARTTask B 2 512 3状态说明R(运行)、B(阻塞)、S(挂起)、D(删除)。四、关键注意事项堆栈单位FreeRTOS 中堆栈大小以 “字” 为单位32 位 CPU4 字节 / 字例如配置 1024 字 4096 字节。高水位线意义剩余堆栈最小值越小说明任务运行时堆栈越接近溢出建议保留至少 20% 的余量。API 调用上下文uxTaskGetStackHighWaterMark()可在任务中调用传 NULL 查当前任务也可在中断外查其他任务。vTaskList()不能在中断中调用且会暂时关闭调度器建议在低优先级任务中调用。栈溢出检测除了主动查询还可开启configCHECK_FOR_STACK_OVERFLOW1 或 2让 FreeRTOS 在检测到栈溢出时调用钩子函数vApplicationStackOverflowHook()。总结查看 FreeRTOS 堆栈的核心是使用uxTaskGetStackHighWaterMark()单任务或vTaskList()全任务需先开启configUSE_TRACE_FACILITY宏。堆栈高水位线是判断栈溢出风险的关键指标剩余值越小风险越高。批量查看任务列表时vTaskList()输出的 “剩余堆栈” 即为该任务的高水位线值可直接反映堆栈使用情况。通过以上方法你可以精准监控每个任务的堆栈使用避免栈溢出问题同时优化内存分配。