1. STM32调试环境搭建：工欲善其事，必先利其器
做嵌入式开发，尤其是跟STM32打交道，调试环境就是你的“战场”。环境没搭好，后面所有排查和调优都无从谈起。这一章，咱们就把Keil MDK、ST-Link、J-Link这些家伙彻底搞定。
我个人习惯是，拿到一块新板子或者新项目，第一件事不是写代码，而是花半小时把调试环境从头到尾验证一遍。为什么？因为我在项目里吃过亏——有一次赶进度，跳过验证直接写代码，结果下载一次要等两分钟，后来发现是调试器驱动版本不对。嗯，从那以后我再也不敢偷懒了。
1.1 Keil MDK安装与配置
Keil MDK是ARM内核MCU开发的主流IDE，尤其对STM32来说，它的编译器效率高、调试功能成熟。说白了，大部分工程师的入门工具就是它。
安装步骤
- 下载安装包：去Keil官网（www.keil.com）下载MDK-ARM最新版本。注意区分版本，MDK-Lite免费但有代码大小限制（32KB），商业项目建议用正版Pro版。
- 安装过程：一路Next就行，但安装路径不要有中文和空格。我习惯装到
C:\Keil_v5，方便后续找文件。 - 安装器件包：打开Keil，点击
Pack Installer，找到STM32F1xx_DFP并安装。没有这个包，你连芯片都选不到。 - 注册许可证：如果是正版，用License Manager导入许可证文件。如果是评估版，注意32KB限制，别写个Demo都超了。
工程配置要点
新建工程时，选对芯片型号是第一步。STM32F103系列有C8、R8、V8等后缀，对应Flash和RAM不同。选错了，调试器连不上是常事。
然后就是 Target 选项卡里的 ARM Compiler 版本。我建议用 V5.06 或 V6.x，V5兼容性好，V6编译快但有些旧代码会报错。你想想看，如果项目是从老工程师手里接过来的，多半是V5，别手痒去升级。
1.2 ST-Link驱动安装
ST-Link是ST官方调试器，买Nucleo板或Discovery板都自带。便宜、够用，但驱动问题经常让人抓狂。
驱动安装流程
- 自动安装：插上ST-Link，Windows 10/11一般会自动识别并安装驱动。如果设备管理器里出现
STMicroelectronics STLink dongle，说明成功了。 - 手动安装：如果没识别，去ST官网下载
ST-Link USB driver或STSW-LINK009。安装后重启电脑。 - 固件升级：ST-Link的固件会随Keil版本更新。打开
ST-Link Utility或Keil里的ST-Link Upgrade，检查固件版本。我曾经遇到过ST-Link连不上芯片，折腾半天发现是固件太旧，升级后秒连。
1.3 J-Link配置
J-Link是SEGGER公司的调试器，速度比ST-Link快，功能也更强大。如果你做性能调优或者调试复杂外设，J-Link是更好的选择。
安装与配置
- 安装驱动：去SEGGER官网下载
J-Link Software and Documentation Pack。安装后，插上J-Link，设备管理器里会出现J-Link driver。 - Keil配置：在Keil的
Options for Target->Debug选项卡里，选择J-LINK / J-TRACE Cortex。然后点Settings，确认Port选SW（SWD模式），Max Clock建议先设4MHz，稳定后再往上调。 - J-Link Commander：这是一个命令行工具，可以用来测试连接、读取芯片ID、解锁芯片。我习惯用它做快速验证：输入
connect，选STM32F103，如果能读到ID，说明硬件连接没问题。
1.4 调试器选型对比
很多新手会问：ST-Link和J-Link到底选哪个？其实没有绝对答案，看你的场景。下面这个表格是我根据自己的经验整理的，你参考一下。
| 对比项 | ST-Link/V2 | J-Link EDU | J-Link PRO |
|---|---|---|---|
| 价格 | 免费（板载） | 约300元 | 约3000元 |
| 调试速度 | 最高4MHz | 最高15MHz | 最高50MHz |
| 断点数量 | 硬件断点6个 | 硬件断点无限（软件模拟） | 硬件断点无限 |
| 性能分析 | 不支持 | 支持基本采样 | 支持高级Trace |
| 适用场景 | 入门、简单调试 | 学生、个人项目 | 商业项目、性能调优 |
我个人建议：如果你只是学STM32或者做简单项目，ST-Link完全够用。但如果你要做RTOS调试、性能分析或者排查复杂Bug，J-Link EDU是性价比最高的选择。至于J-Link PRO，那是给公司项目准备的，个人用户没必要花那个钱。
1.5 调试环境整体流程
下面这张图是我画的调试环境搭建流程，从安装工具到验证连接，一步都不能少。你跟着走一遍，基本不会出问题。
1.6 验证环境是否正常
环境搭好了，怎么知道它能不能用？写个最简单的程序，下载进去，看LED灯亮不亮。如果亮了，说明环境没问题。如果不亮，按下面步骤排查：
- 检查设备管理器：看调试器有没有被识别。没识别就重装驱动。
- 检查接线：SWD只需要4根线——SWDIO、SWCLK、GND、3.3V。别接反了，我见过有人把SWDIO和SWCLK接反，折腾半天。
- 检查Keil设置：Debug选项卡里选对调试器，Utilities选项卡里选对Flash算法。STM32F103的Flash算法是
STM32F10x Med-density Flash。 - 检查芯片供电：用万用表量一下VDD引脚，确保有3.3V。有时候板子没上电，调试器也连不上。