单片机与物联网 / 系统课时
断点与单步调试
断点与单步调试
本课通过一个可观察的 STM32 示例,说明如何用断点暂停程序、用单步命令跟踪分支、借助调用栈确认函数路径,并在变量窗口中定位数据异常。完成后,你可以按固定顺序判断问题发生在“没有执行到”“执行顺序错误”还是“变量值错误”。
学习目标
- 正确使用普通断点、条件断点和单步命令
- 通过调用栈和变量窗口还原程序执行现场
- 避免在中断、实时任务和外设时序中误用断点
准备并复现异常
下面是放入 STM32CubeMX 生成工程中的片段示例,依赖已经初始化的 HAL 库和 GPIO,不能脱离具体芯片工程独立运行。代码故意保留一个边界判断错误:采样值等于阈值时,告警不会触发。
#include "main.h"
#include <stdint.h>
static uint8_t alarm_enabled = 1;
static uint16_t threshold = 2000;
static uint8_t should_alarm(uint16_t sample)
{
// 故意使用 >,便于在调试器中观察边界错误
return alarm_enabled && (sample > threshold);
}
static void process_sample(uint16_t sample)
{
uint8_t alarm = should_alarm(sample);
HAL_GPIO_WritePin(
GPIOC,
GPIO_PIN_13,
alarm ? GPIO_PIN_RESET : GPIO_PIN_SET
);
}
void debug_demo(void)
{
uint16_t samples[] = {1800, 2000, 2200};
for (uint32_t i = 0; i < 3; ++i) {
process_sample(samples[i]);
}
}预期结果
sample=1800 时 alarm=0
sample=2000 时 alarm=0
sample=2200 时 alarm=1在 main() 完成外设初始化后调用 debug_demo(),GPIO 端口和引脚应按开发板原理图调整。如果需求是“采样值达到阈值就告警”,第二组结果已经表明问题位于边界判断。
用断点与单步锁定根因
先在 process_sample() 第一行设置普通断点,再以 Debug 模式启动程序。程序暂停后观察 sample、threshold 和 alarm_enabled。若断点始终未命中,应先检查 debug_demo() 是否被调用、编译优化是否影响源码映射,以及当前固件是否已经重新下载。
循环次数很多时,可把断点条件设置为 sample == 2000。条件断点只在表达式成立时暂停,能减少无关停顿,但表达式求值仍有开销,不宜在高频中断中长期使用。

“单步跳过”执行当前行但不进入被调用函数,适合越过已确认无误的 HAL 调用;“单步进入”会进入函数内部,适合检查 should_alarm();“单步跳出”会执行完当前函数并返回调用者。调试本例时,在 sample 为 2000 的现场单步进入条件判断,即可看到 sample > threshold 为假。
把条件修改为 sample >= threshold 后重新编译,保留条件断点再次验证。修复后的预期结果如下。
sample=1800 时 alarm=0
sample=2000 时 alarm=1
sample=2200 时 alarm=1结合调用栈和变量窗口判断现场
调用栈按“当前函数在上、调用者在下”的顺序展示执行链。本例正常路径应为 debug_demo() → process_sample() → should_alarm()。切换到某一栈帧,可以查看该层的局部变量和源码位置;错误参数往往在上层调用者中就已形成,不能只看最顶层函数。
Variables 窗口适合查看当前栈帧中的局部变量,Expressions 或 Watch 窗口适合持续观察全局变量、结构体成员和表达式。对被中断或 DMA 修改的共享变量,应使用 volatile,否则优化器可能让窗口中的值与实际内存变化不一致。
断点会停止 CPU,但定时器、看门狗或外部设备未必同时停止。暂停过久可能引发通信超时、看门狗复位或控制失步。时序敏感问题应优先使用串口日志、数据追踪或逻辑分析仪,而不是反复停机。