4. IDE 调试环境搭建：Keil MDK 与 IAR 实战配置
调试环境搭建，说白了就是让你的电脑和 STM32 芯片能“对上话”。我见过不少新手，代码写得挺好，结果卡在调试器连不上，一查是驱动没装对。嗯，这章咱们就把这事彻底理清楚。
4.1 ST-Link 驱动安装与固件升级
ST-Link 是 ST 官方调试器，也是我们课程的主力工具。我个人习惯，拿到新板子第一件事就是升级 ST-Link 固件——别问我为什么，有一次项目赶进度，板子死活连不上，最后发现是出厂固件版本太老。
4.1.1 驱动安装步骤
- 下载 ST-Link 驱动包：去 ST 官网搜 "ST-Link driver"，或者直接用 STM32CubeProgrammer 自带的驱动。
- 安装：双击运行，一路 Next。Windows 10/11 通常会自动识别，但建议手动装一次。
- 验证：插上 ST-Link，打开设备管理器，看到 "STMicroelectronics STLink dongle" 就对了。
4.1.2 固件升级流程
为什么要升级？因为旧固件可能不支持新芯片，或者有已知 bug。我曾经被 ST-Link V2 的旧固件坑过，调试时断点总失效，升级后问题消失。
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 下载 ST-Link Utility 或 STM32CubeProgrammer | 推荐后者，功能更全 |
| 2 | 连接 ST-Link 到电脑 | 确保 SWD 线没接反 |
| 3 | 打开软件，点击 "Firmware Update" | 软件会自动检测当前版本 |
| 4 | 点击 "Upgrade" | 等待进度条走完，不要拔线 |
4.2 Keil MDK 调试配置
Keil MDK 是 ARM 生态的老牌 IDE，配置调试其实不复杂，但细节容易漏。你想想看，如果 Debug 选项卡没选对调试器，点下载按钮就是摆设。
4.2.1 配置步骤
- 打开工程，点击菜单栏的
Project → Options for Target（或者直接点魔术棒图标）。 - 切换到 Debug 选项卡，在右侧下拉框选择
ST-Link Debugger。 - 点击 Settings，进入 ST-Link 详细配置界面。
Settings 里要确认几件事：
- Port：选 SWD（别选 JTAG，除非你板子只支持 JTAG）。
- SW Device ID：如果能识别出芯片型号，说明连接正常。
- Clock：默认 4MHz 就行，如果线长可以降到 1.8MHz 保证稳定。
4.2.2 下载与调试设置
回到 Debug 选项卡，勾选 Load Application at Startup 和 Run to main()。这样一启动调试，程序会自动下载并停在 main 函数入口。
我个人习惯还会在 Flash Download 选项卡里勾选 Reset and Run，这样下载完程序自动复位运行，省得每次手动按复位键。
// 配置完成后，点 Debug 按钮，你应该能看到：
// 1. 代码停在 main 函数第一行
// 2. 左侧寄存器窗口显示当前值
// 3. 右下角 Call Stack 窗口为空（还没调用函数）
4.3 IAR 调试配置
IAR 的配置逻辑和 Keil 类似，但界面布局不同。我第一次用 IAR 时找了半天 Settings 在哪——其实就在 Project → Options 里。
4.3.1 配置步骤
- 打开 Options：右键工程名，选
Options，或者快捷键 Alt+F7。 - 进入 Debugger 分类：在左侧列表找到
Debugger，右侧Setup选项卡里选ST-Link。 - 点击 OK，再进入
ST-Link分类（在 Debugger 下面）。
在 ST-Link 分类里：
- Interface：选 SWD。
- Speed：建议选 "Automatic" 或 4MHz。
- Reset：选 "Normal" 或 "SYSRESETREQ"，看板子支持哪种。
Debugger → Images 选项卡里，勾选 Download extra image，然后选择对应的 .flash 算法文件。我曾经忘了这步，下载时提示 "No algorithm found"，折腾了半小时才想起来。
4.3.2 调试视图
IAR 的调试界面比 Keil 更“硬核”一些。我个人喜欢它的 Live Watch 功能，可以实时查看变量变化，不用暂停程序。
| 功能 | Keil MDK | IAR EWARM |
|---|---|---|
| 调试器选择 | Debug 选项卡 | Debugger → Setup |
| SWD 配置 | Settings → Debug | ST-Link → Interface |
| 下载算法 | Flash Download 选项卡 | Debugger → Images |
| 复位方式 | Settings → Debug | ST-Link → Reset |
4.4 调试环境知识体系
下面这张图帮你理清整个调试环境的搭建逻辑。说白了，就是三层：驱动层、IDE 配置层、硬件连接层。哪一层出问题，调试器都连不上。
4.5 常见问题与排查思路
调试环境搭建过程中，我总结了一套“三板斧”排查法：
- 看灯：ST-Link 上的指示灯亮不亮？不亮先查 USB 线和供电。
- 看设备管理器：驱动装没装？有没有黄色感叹号？
- 看 IDE 日志：Keil 的 Build Output 窗口、IAR 的 Debug Log，都会告诉你连没连上。
嗯，到这步，你的调试环境应该已经跑起来了。接下来就可以真正开始调试代码了——不过那是后面章节的事。先把环境稳住，后面才不慌。