调试这事儿说简单也简单说难也难。很多刚接触单片机的同学写代码的时候挺顺畅编译一通过就以为万事大吉等点开调试器一看变量变化、看程序行为直接傻眼。还有一批人编译过了就烧录烧完发现功能不对只能在代码里“盲改”改一次烧一次跟开盲盒似的。其实Keil这种IDE自带的调试功能已经非常能打了只是大多数人没系统用好它。这篇文章不聊那些花里胡哨的东西就把我在实际项目中用Keil调试STM32的那套流程、踩过的坑、摸索出来的经验掰开揉碎讲一遍。适合刚接触Keil调试的新手也适合那些平时只会全速运行加断点的同学看完之后你会发现原来程序错误是可以这样一步步“揪”出来的。1. 调试前的编译与连接配置这一步没做对后面全是坑很多人的调试体验差问题根本不在调试操作而是配置压根就没弄对。调试还没开始Keil就在“无声拒绝”你。1.1 三个必须勾选的选项Debug Information、Create HEX File、Browse Information先打开魔术棒Options for Target在Output标签页能看到几个关键选项。Debug Information这个默认是勾上的。如果哪天你发现调试器进去了但是代码窗口是花的变量看不了函数跳转失灵十有八九就是这个选项被关了。它的作用是在编译时生成调试符号表Keil靠它把机器码和源码行对应起来。没有了它调试器就像给你一张没标路名的地图根本定位不了。Create HEX File这个很多人知道是要生成hex烧录文件用的。但我要提醒一下Keil在调试模式下真正用来下载烧录的是一个叫axf的文件不是hex。axf是ARM的ELF格式调试文件里面包含了调试信息和代码数据烧录器下载固件时实际上用的就是它。如果这个选项没勾编译只生成axf一样能调试但你想拿hex去别的工具烧或者给同事发固件就找不到了。Browse Information在Output标签里叫Browse Information它的作用是生成代码浏览信息。没勾它右键Go To Definition、Find References这类功能会失效调试时想去查一个变量在哪些地方被改过特别不方便。这三个选项我建议全部勾上。调试不顺的时候先检查这里别急着怀疑代码。1.2 仿真器连接ULINK/CMSIS-DAP/J-Link怎么选在Debug标签页里你能看到两个选项Use Simulator和Use ULINK/CMSIS-DAP Debugger实际上就是你到底是用软件仿真还是用真机硬件调试。用真机调试的话选择右边的“Use”加下拉框里的调试器类型。最常见的三种CMSIS-DAP很多开发板板载的调试器就是这种比如NXP、GD32的板子便宜好用Keil自带驱动基本免配置。J-LinkSEGGER的东西速度比CMSIS-DAP要快一些功能也更强比如J-Scope、RTT这些高级玩法。但它用的是SEGGER的驱动Keil要正确识别需要装好SEGGER的软件包。ULINKKeil自家硬件和Keil配合理论上最无缝但价格摆在那儿个人开发者用得少。这里有个很容易踩的坑选对了仿真器类型但你发现Debug标签下面那个Settings还是灰色打不开或者点击Settings后弹出错误说明Keil没有识别到调试器。这时候先别怀疑硬件坏了先把USB线换一根然后去设备管理器看看有没有识别到调试器设备。很多所谓的“调试器不识别”最后都是USB线只能充电不能传数据。1.3 Flash Download与Programming Algorithm到底在干什么选择好调试器之后点旁边的Settings按钮进入Debugger设置页。这里要重点说的是Flash Download标签也就是热词里提到的flash download设置里的programming algorithm。很多人搞不懂这个Flash的编程算法是干嘛的。我举个例子你把程序烧进单片机Flash本质上是往Flash寄存器里写入某个地址的指令序列让芯片自己去擦除扇区、写入数据、校验结果。不同芯片的Flash操作时序不一样所以需要用一段对应芯片的驱动代码来帮下载器完成这个“翻译”工作。这段驱动代码就是Programming Algorithm。在Flash Download设置里你会看到左边一个列表列出了当前支持的Flash算法比如STM32F103C8T6对应的是128K Flash的算法。如果这里空着或者选错了型号烧录时就会报错“No Algorithm found”或者编程校验失败。选择方法是点Add按钮在弹出的窗口里根据你的MCUFlash容量选对应的算法。选完后下面还能勾选“Erase Full Chip”擦除整个芯片或者“Erase Sectors”按扇区擦除。“Reset and Run”也建议勾上这样烧录完成后芯片自动复位运行不用每次烧完手动按复位键。我之前帮一个朋友调板子他的芯片是GD32F103但工程里默认选的是STM32F103的Flash算法烧进去也能跑但偶尔会出现校验错误、程序跑飞的情况。后来换成GD32官方的算法一切正常。这件事提醒我Flash算法一定要选对。2. 断点与单步把程序“定格”在出问题的瞬间配置搞定了接下来就进入正题。调试最常见的手段就是断点和单步。这才是把程序“定格”下来逐一审视的关键。2.1 断点的种类与限制硬断点、软断点为什么断点数量有限很多人对断点的理解就是“点一下代码行前面的灰色区域出现个红点运行到这里就停”。但你们有没有遇到过这种情况调试器提示“Cannot set breakpoint”断点打不上或者在Cortex-M0芯片上只能打四个断点这里涉及到硬断点和软断点的区别。硬断点利用芯片调试模块的硬件比较电路程序运行到指定地址时触发。Cortex-M3/M4基本支持6个左右M0只有4个。这类断点可以设在Flash代码区不管程序怎么跑都能触发。特点是数量有限但是可靠。软断点Keil在调试时如果硬断点资源用完了会尝试用软断点。它是在目标代码里插入一条特殊指令执行到这条指令时产生异常进入调试状态。软断点数量几乎不受限制但它需要目标Flash支持运行时写操作而且如果Flash被保护就没法用。我的经验是不要无脑打几十个断点真没必要。调试讲究的是“二分法定位”。如果你的程序在一个大循环里功能出问题时先在循环中间打一个断点看程序有没有走到这一步走到了问题在后半段没走到问题在前半段。不断缩小范围很快就能锁定问题。2.2 单步调试四兄弟Step Into、Step Over、Step Out、Run to Cursor Line断点让程序停下来之后真正精细观察就要靠单步了。Keil调试工具栏上有几个图标Step IntoF11单步进入。遇到函数调用时会跳进函数内部一行一行地执行。如果你想检查某个子函数内部的执行路径用这个。Step OverF10单步跳过。如果当前行是函数调用它不会进入函数内部而是把整个函数当作一步执行完。想跳过库函数、不关心细节时用这个。Step OutCtrlF11单步跳出。如果刚才进入了某函数现在想一口气跑完当前函数并返回到调用处用这个。Run to Cursor LineCtrlF10运行到光标所在行。这个非常实用不需要打断点把光标点到你想停的位置程序运行到那行就停。相当于临时断点。我的调试习惯是这样的先用F5全速跑到大致的错误区域让程序停在某个断点然后切到Step Into逐行检查遇到底层库调用、不关心的部分就用Step Out跳出去继续走主逻辑。这套组合拳打下来基本能把程序的执行脉络弄得明明白白。2.3 条件断点与数据断点复杂逻辑排查利器有些Bug藏在特定条件下比如当某个变量等于100的时候程序才崩溃或者当串口收到特定数据时才对。这种场景下无脑断点会造成几千次触发手动按F5按到手酸。条件断点就派上用场了。在Keil的Breakpoints窗口Debug菜单→Breakpoints里选中一个已有的断点在Expression栏可以输入条件表达式比如counter 100意思是只有这个变量等于100的时候才触发断点。还可以勾选“Count”设置跳过前N次。数据断点也是好东西Keil里叫Access Breakpoint你可以在变量上右键选择“Set Access Breakpoint at...”设置读、写或者读写触发。比如你需要知道某个全局变量是在哪里被意外修改的就对它设一个“Write”断点一旦有代码写了它程序立刻停下调用栈窗口就直接告诉你凶手是谁。这个方法在排查全局变量被踩、结构体内容被莫名篡改这类问题的时候几乎是必杀技。3. 变量与内存查看把程序“解剖”开来看断点停住了程序当前状态就冻结了这时候就可以开始“解剖”程序看看各个变量到底存的是什么。3.1 Watch窗口与结构体变量的正确展开姿势在调试状态下View→Watch Windows打开Watch 1或Watch 2窗口。在里面双击空白行输入你想要观察的变量名回车就能看到它的当前值。这是最基础的用法。但热词里专门有人搜“keil调试助手里面的debug模式如何显示结构体变量”说明结构体查看这个功能确实卡住不少人。实操中你可以这样做先在源代码里找到那个结构体变量比如叫g_sysConfig在Watch窗口里直接输入这个名字回车后它会显示一个结构体类型左边有个“”号。点击展开就能看到里面每一个成员变量以及它们的值。如果你要监视的是结构体指针比如pConfig直接在Watch窗口输入pConfig看到的是一串地址不是成员值。这时候要输入(*pConfig)回车后展开才能看到指针指向的实际结构体内容。这是一个非常重要的细节新手十有八九会卡在这里。另外如果结构体里嵌套了数组或者别的结构体同样可以逐级展开。想快速复制某个数组元素值可以选中数组名输入g_data[0]这种形式就能只看前几个元素不用把几百个元素全部展开。3.2 Memory窗口直接看地址上的数据Watch窗口是按变量类型来解析数据的但有些场景你关心的是原始内存。比如看一个A/D采样的缓冲数组里到底存了什么或者确认某段地址的数据有没有被篡改这时候要用Memory窗口。在View→Memory Windows里打开Memory 1在地址栏直接输入你想要查看的地址比如0x20000000STM32的SRAM起始地址。然后右键可以选择显示格式1字节(U8)、2字节(U16)、4字节(U32)都能切换。这个窗口在调试时特别适合做这几件事查看结构体在内存中的实际布局。在Watch窗口里可以看到变量地址把这个地址填进Memory窗口就能看到这个结构体在内存中的原始字节。查看数组缓冲区是否溢出。如果你的数组定义为u8 buffer[16]那么在Memory窗口里看buffer之后的16个字节再往后的数据如果出现过不该有的变化大概率是缓冲区越界了。查看某个外设的寄存器值。比如GPIOA的基地址是0x40010800F103填进去就能直接看到对应寄存器的值配合数据手册比对各个位的含义。3.3 外设寄存器查看System Viewer和Peripherals除了自己输地址Keil还给STM32的开发者准备了一个更直观的外设寄存器查看方式Peripherals菜单。在调试状态下Peripherals菜单下面会有System Viewer里面有芯片各个外设的列表比如GPIO、USART、TIM、ADC这些。点开一个外设比如GPIOA就会看到这个端口每个引脚的模式、输出类型、速度、上下拉等配置以及当前引脚电平是高是低。这些数值不是纯十六进制那一堆而是Keil按寄存器位定义解析好的直观列表。对于调试串口通信这种场景Peripherals里看USART特别方便。打开USART1能看到它的波特率寄存器值、发送/接收数据寄存器、状态位TXE、RXNE等。程序卡在某个串口等待循环时一眼就能判断到底是没发出去还是没收到。这个功能价值在于它可以帮你把“C语言变量”和“硬件寄存器”对应起来。很多新手写驱动代码时对寄存器修改的实际效果没有概念打开System Viewer盯着寄存器变化看几轮很多外设工作原理瞬间就通透了。4. 堆栈、调用栈与HardFault定位程序跑飞了怎么查调试到深处总会遇到程序莫名跑飞、死机、进了HardFault的情况。这种问题最让人头疼但Keil提供的堆栈和调用栈工具正是处理这类问题的利器。4.1 调用堆栈窗口函数是怎么一层层调进来的View→Call Stack Window打开调用堆栈窗口。当程序停在某个断点时这个窗口会显示从main函数一路调用到当前断点的调用链。比如你在某个外设中断处理函数里打了断点调用栈会显示出main→...→中断服务函数的调用路径。这个功能在实际调Bug时超级有用。我有一次遇到一个现象某个函数本该返回一个计算值但返回值总是错的。我在函数内部设断点看到计算的每一步都对出来结果却不对。打开调用栈才发现这个函数在另一个文件中还有一处一模一样的调用而我在错误的那一处修改了代码。调用栈能迅速帮你建立“当前代码处于哪个上下文”的空间感排查这种伪Bug特别有效。另外调用栈窗口每一行通常还会显示当前函数内的局部变量点击对应的调用层级就能直接看到那一层函数的局部变量现场。这在排查递归调用、多层嵌套调用时尤其好用。4.2 查看堆栈与栈溢出排查热词里有人问“keil调试stm32如何查看堆栈”这里重点说。STM32启动文件里会为C运行环境分配栈空间Stack_Size EQU 0x00000400这样的定义代表栈大小为1KB。如果程序里局部变量太大或者递归过深栈空间耗尽就会发生栈溢出导致程序跑飞或者进入HardFault。那么怎么在调试时查看堆栈看两点就够了。看调用堆栈窗口的长度如果调用栈窗口里显示出的层级特别多或者栈回溯信息错乱显示一堆奇怪的地址说明栈很可能出了问题。Memory窗口里看栈顶方向Cortex-M的栈是从高地址往低地址生长的。你可以在Memory窗口里定位到栈底也就是初始SP地址往下看一段区域。如果正常程序运行栈空间使用可以估算你可以填个0xAA之类的填充值运行后看哪些区域被覆盖成实际数据。启动文件里通常栈区初始化为全0如果你看到栈区里的数据压得很深离栈底没剩多少说明栈空间紧张就该去启动文件里把Stack_Size改大一些比如从0x400改成0x800或者0x1000。还有一个典型的栈溢出问题某个大型局部数组定义在函数内部比如u8 Buffer[1024]加起来超过栈大小程序一调用这个函数数据直接写到栈外把其他变量覆盖了。这种问题用上面的方法很容易看穿。4.3 HardFault_Handler点进去一顿乱找有技巧的程序进HardFault后按照教程都会建议你在HardFault_Handler里打断点然后点进去观察。但进去之后呢很多人面对一堆汇编代码直接懵了。有个方法论要记住进HardFault后第一件事不是看当前行代码而是看Core Registers窗口View→Registers Window里的PC和LR寄存器。查看PC程序计数器当前值对应到代码窗口或者用Memory窗口查这个地址附近的反汇编内容就能定位到造成异常的指令。查看LR链接寄存器。如果异常优先级足够高LR会存有异常返回序列从中能算出进入异常前正在执行的函数地址。还可以查看xPSR如果某个位比如除法除零标志发生变化也能给出异常原因的线索。我常用的做法是在HardFault_Handler里打断点然后打开反汇编窗口View→Disassembly Window把PC寄存器的值填到Disassembly的地址栏里直接看那行汇编。如果发现是LDR或者STR指令八九不离十是访问了一个非法的指针地址如果是一堆奇怪的指令大概率是栈被破坏导致PC跳到乱七八糟的地址。这种定位方式比盲猜要高效太多。5. 串口打印与软件仿真没有板子也能调有板子更好调有些场景不需要硬件纯软件仿真就能调有些场景必须在真机上但输出日志能极大加快排查。下面这两块内容都很关键。5.1 Printf重定向到串口和Debug (printf) Viewer程序问题五花八门断点不可能解决所有问题比如实时性要求高的场景你断下来就破坏了时序。这时候日志输出就特别重要。最常规的做法是重定向printf到串口。在Keil里重定向printf只需要做两件事第一勾选魔术棒→Target标签→Use MicroLIB。MicroLIB是Keil针对嵌入式场景裁剪的精简C库用它能避免引入完整C标准库后printf重定向的复杂性。第二在工程里重写fputc函数#include stdio.h int fputc(int ch, FILE *f) { // 等待上一个字节发送完成 while ((USART1-SR USART_FLAG_TXE) 0) ; // 发送一个字节 USART1-DR (uint8_t)ch; return ch; }这样一个简单的重定向之后所有printf内容就能从串口1发出去接一个USB转TTL就能在电脑上看到打印信息。不过我要分享一个Keil的隐藏小功能Debug (printf) Viewer。在调试状态下View→Serial Windows→Debug (printf) Viewer配合上面的重定向代码程序里的printf不会发到串口UART而是直接在Keil的这个调试窗口里显示完全不需要外接串口线。实现方式是在魔术棒→Debug→Settings里勾选Trace Enable并把Core Clock设置成和你芯片实际频率一样。这样SWO引脚会直接把printf的数据传到调试器再显示在Keil里。前提是调试器J-Link或CMSIS-DAP硬件上支持SWO。5.2 软件仿真模式怎么用Simulator配置与Dialog DLL参数如果手头没有板子或者程序逻辑需要脱离外设跑通Keil自带的软件仿真Simulator可以用来应付很多场景。在魔术棒→Debug标签页选择“Use Simulator”然后点开旁边那个Settings。这里有一个很多教程没写清楚的地方Simulator的Dialog DLL参数。在仿真模式初始化的配置里需要填两行DLL参数Dialog DLLDARMSTM.DLLParameter-pSTM32F103C8根据你的芯片型号填对应的参数这行的作用是让Keil在仿真时加载对应芯片的外设模拟模型这样你能在软件仿真模式下照样打开System Viewer查看GPIO、UART这些外设的状态变化。如果不填仿真时外设寄存器会始终无变化看起来像死机。模拟器模式的调试操作和硬件调试完全一样断点、单步、Watch窗口、Memory窗口都能用。尤其适合调试纯算法逻辑比如PID计算、滤波算法、协议解析、状态机转换。这些逻辑不依赖具体硬件时序模拟器跑起来跟真机几乎没区别还不用考虑烧录的麻烦。5.3 软件仿真能调什么不能调什么我是认真的软件仿真也有明显的边界。我总结下来大致是这样能调纯运算逻辑、变量逻辑分支、内存操作、数组处理、简单的定时器模拟需要配置好时钟频率。不太能调ADC采集模块模拟电压输入很难在Simulator里模拟、外部中断时序没有真实的引脚信号、Flash操作仿真模式下Flash模拟和真机行为可能有差异、带死区等复杂时序的PWM驱动表现。所以我的习惯是先仿真调逻辑再烧板子调时序。上板后遇到功能性问题再用Peripherals和System Viewer去对照硬件状态。这样效率最高也最省开发板。6. 常见报错与问题排查实录新手必收藏这一节专门做问题排查。很多报错本身不是程序逻辑问题而是开发环境或者配置问题引发的这类问题最烦人却也是最好解决的。6.1 Keil 5报No ULINK Device Found这是热词榜上的高频词。Keil点下载时报“No ULINK Device Found”说明它根本没找到你的下载器。排查顺序非常重要不要乱检查原理图或开发板说明书确认调试器的接线是不是对了TMS、TCK、GND最多加个VCC或RST不要接反。打开设备管理器看调试器对应的设备有没有被认出来有没有黄色感叹号。如果没认出重装驱动。在魔术棒→Debug标签确认勾选的调试器类型和实际硬件一致。比如你是J-Link却选了CMSIS-DAP它肯定找不到。点击Debug旁边那个Settings看“SW Device”列表里能不能读出IDCODE。能读出来说明连接通了报No ULINK通常就是选项Selector没选对或者接线有问题。还要检查芯片是不是进入了低功耗停机模式。有些MCU进入Stop模式后SWD口会失效连接不上这种情况要靠复位电路或者拉高BOOT0再连接。6.2 Error: R6002 Floating point support not loaded这个报错老版本Keil用户遇到得多。报错信息意思是“浮点支持未被加载”本质上是Keil的某个DLL加载失败多见于旧版本或是系统环境缺少必要的运行库。解决办法优先级从高到低直接升级到当前最新版MDK官方早就修复了这类兼容性问题。以管理员身份运行Keil。安装系统VC运行库有些精简版系统缺了这些库导致DLL加载失败。实在不行换一台机器装一个干净的Keil版本。遇到这个报错不用紧张它通常不影响你的源代码纯粹是环境问题。6.3 “该进程已终止因为它无法分配更多的内存”Debug运行时报这个错表示目标调试会话内存不足。我在大工程尤其是有大量优化、全源码编译的工程里遇到过多次。造成原因通常是这几类工程太大Keil调试时开了太多窗口和Trace功能占用了宿主机内存。杀毒软件实时监控导致内存分配异常。工程路径包含中文或特别长的目录间接触发各种诡异问题。解决办法把工程放到一个纯英文、短路径的目录关闭杀毒重试关闭不必要的调试窗口比如把Trace窗口、逻辑分析仪窗口关掉把编译输出目录里的临时文件清理掉output文件夹重新编译再调试。6.4 工程文件夹改名后一堆文件丢失错误这也是一项热搜问题。很多人把整个工程文件夹复制到别的电脑或者换了目录后一打开工程源码文件全变灰了点击报找不到文件。原因在于Keil工程文件里的源码路径是相对路径引用的但如果你连文件夹名字一起改了原有的相对路径就失配了。解决办法有两个方向一种是回到原目录打开工程在Project窗口里把所有文件移除再重新Add Existing Files添加一遍然后保存工程。另一种是养成良好的工程目录习惯。我一般只建一个根文件夹里面包含Core启动文件和系统文件、Hardware外设驱动、Usermain函数等、MDK-ARMKeil工程文件。根文件夹追一个带版本号的目录名内部结构不动。这样你把整个根文件夹拷贝改个名字Keil工程的相对路径不受影响打开就能编译。我靠着这个习惯这几年给同事共享工程从没遇到过路径问题。6.5 调试时显示No debug information或者无法设置断点“No debug information found”这句话出现时先检查Output里Debug Information有没有勾再检查是不是代码被优化掉了。优化是最让调试图省心又心烦的东西。ARM Compiler 5的-O0是关闭优化调试体验最好变量值都能看-O3优化最强可能让你设置的断点根本不起作用因为代码被合并或者重排了。ARM Compiler 6AC6则默认优化等级较高-O1及以上变量可能被优化成寄存器Watch窗口看了显示“optimized out”。所以调试时我的建议是把魔术棒→C/C→Optimization改成-O0或者Debug等级调试完再开回高优化。有些人执着于在高优化下调试那是能提高代码性能但对排查问题来说非常不友好新手建议老老实实关优化调试。另外网络热词中提到的AC5/AC6编译器切换也在这里补充一句。Keil MDK 5.37之后安装默认只带AC6编译器。如果你拿到的老工程是用AC5写的在魔术棒工具栏那里会有编译器选择。没有AC5的话在Pack Installer的Legacy Support里找AC5编译器组件安装就好。最后讲一个个人体会非常深的点调试是“时间的老虎”。学会用Keil提供好的断点、单步、Watch、内存、寄存器、调用栈这些工具能帮你在排查Bug时节约大量时间而且让你逐渐形成对代码和硬件行为的直觉。我见过太多人对调试工具囫囵吞枣只会全速运行加看串口打印遇到怪问题就改代码碰运气。工具就在手边踩过的坑也列出来了下次遇到问题先打开调试器把程序“冻”住慢慢看数据和调用链条。你会发现绝大多数问题在冷冰冰的数据面前都藏不住。