从 0 到 1！Keil uVision5 调试 STM32 项目全流程拆解（附实战代码 + 排错手册）

1. 从“灯不亮”开始：一个真实的调试故事

我猜很多朋友第一次用Keil捣鼓STM32，都经历过那个让人抓耳挠腮的时刻：代码编译得漂漂亮亮，下载过程也显示“成功”，但板子上的LED就是死活不亮。你反复检查代码，确认引脚没配错，延时也给了，甚至开始怀疑是不是买到了坏板子。别急，这几乎是每个嵌入式新手的“成人礼”。今天，我们不只讲怎么点亮一个灯，而是要带你走一遍完整的调试流程，把Keil uVision5这个工具用透，让你下次再遇到问题，能像个老手一样，淡定地打开调试窗口，一步步把“病根”揪出来。

调试是什么？在我看来，它就像给单片机做“体检”。代码是“药方”，编译下载只是“把药喂进去”，而调试，就是拿着听诊器、X光机，看看这药到底起没起作用，是剂量不对，还是压根儿没吃进去。很多人怕调试，觉得那是高手才玩的东西。其实不然，调试工具就是给你开的“天眼”，让你能看见程序在芯片里是怎么跑的。这次，我们就以最经典的STM32F103C8T6最小系统板为例，假设你已经写好了LED闪烁的代码，但灯不亮。别慌，跟着我，咱们一起用Keil的调试器，把问题从硬件到软件，一层层剥开。

你需要准备的东西很简单：一块STM32开发板（比如常见的“蓝色小药丸”）、一个ST-Link调试器（V2或者V3都行）、几根杜邦线，以及一台已经装好Keil MDK-ARM（我们习惯叫Keil5）的电脑。软件方面，确保你已经安装了STM32F1系列的器件支持包，并且项目里正确添加了标准外设库或者HAL库的头文件路径。如果这些基础步骤你还不熟，可以先快速回顾一下新建工程和编译配置的过程，我们马上要进入的是更深入的“诊断”环节。

2. 调试前的最后检查：别让低级错误浪费你的时间

在急吼吼地按下调试按钮之前，花五分钟做一次系统性的检查，能帮你排除掉80%的“伪问题”。我踩过太多坑，很多次折腾半天，最后发现是线没接好或者配置选错了。所以，咱们先建立一个检查清单。

### 2.1 硬件连接与供电确认

首先，把ST-Link和你的开发板连好。ST-Link一般有四个关键引脚需要连接：SWCLK（时钟）、SWDIO（数据）、GND（地）和3.3V（电源）。这里有个关键点：我强烈建议你先只连接SWCLK、SWDIO和GND这三根线，开发板的电源由它自己的USB口或者外接电源单独提供。为什么？因为有些ST-Link的3.3V输出带载能力很弱，直接用它给核心板供电可能导致电压不稳，调试器都连不上。确保开发板上的电源指示灯（通常是3.3V或PWR灯）是亮着的。然后，检查你的LED电路。是用板载的LED（比如连接在PC13脚），还是自己外接的？如果是外接的，确认LED的正负极没有接反，限流电阻（通常220欧姆到1K）是否焊上或接上了。这些看似小儿科的地方，往往是问题的源头。

### 2.2 Keil工程配置深度核查

打开你的Keil工程，点击那个魔法棒图标（Options for Target）。我们重点看两个标签页。第一个是Debug标签。在这里，你要确认右侧的调试器选择的是ST-Link Debugger，而不是默认的Simulator（软件模拟）。然后点击旁边的Settings按钮。在弹出的窗口中，查看Debug页签，Port是否选择了SW（这是STM32最常用的调试接口）。再切换到Flash Download页签，这里至关重要。确保Download Function区域里，Erase Full Chip（下载前擦除整片）和Program（编程）是勾选的。最下面那个Reset and Run<