1. 调试环境搭建：硬件准备、软件安装与驱动配置
调试环境搭建，说白了就是给你的开发板配上趁手的工具。我见过不少新手，代码写得挺漂亮，结果卡在环境配置上，一卡就是半天。嗯，咱们今天就把这事捋清楚。
1.1 硬件准备：选对调试器
调试器是连接电脑和开发板的桥梁。目前主流的选择就两个：J-Link 和 ST-Link。
| 调试器 | 适用场景 | 我的建议 |
|---|---|---|
| J-Link | 通用调试，支持多种ARM芯片 | 性能稳定，调试速度快，适合复杂项目 |
| ST-Link | 专用于STM32系列 | 性价比高，Nucleo/Discovery板自带，入门首选 |
我个人习惯用 J-Link，因为它的断点管理更灵活。但如果你手头有 ST 官方的 Nucleo 板，上面自带的 ST-Link 完全够用，别浪费钱再买一个。
1.2 软件安装：三大IDE怎么选
目前主流的开发环境有三个：Keil、IAR、STM32CubeIDE。你想想看，选哪个其实取决于你的项目需求和钱包厚度。
Keil MDK
Keil 是 ARM 生态的老牌 IDE，界面简洁，编译效率高。但它的许可证不便宜，个人版也要几千块。我刚开始做嵌入式时用的就是 Keil，上手快，资料多，遇到问题随便一搜就有答案。
IAR Embedded Workbench
IAR 的优化能力很强，生成的代码体积小、运行快。如果你做的是量产产品，IAR 值得投资。不过它的界面风格有点老派，快捷键和 Keil 不太一样，切换过来需要适应几天。
STM32CubeIDE
这是 ST 官方推出的免费 IDE，基于 Eclipse 开发。它集成了 CubeMX 配置工具，可以图形化配置时钟、外设、中间件。说白了，你点点鼠标就能生成初始化代码，省去手写寄存器配置的麻烦。
1.3 调试器驱动配置
硬件连好了，软件装好了，接下来就是让电脑认识你的调试器。这一步看似简单，但坑不少。
J-Link 驱动安装
- 从 Segger 官网下载 J-Link 软件包（包含驱动和调试工具）
- 安装时选择「Install USB Driver for J-Link」
- 插上 J-Link，打开设备管理器，确认出现「J-Link」设备
我曾经遇到过一个问题：J-Link 插上后电脑没反应。后来发现是 USB 线的问题——有些线只能充电，不能传数据。嗯，这坑我替你们踩过了。
ST-Link 驱动安装
- 安装 STM32CubeIDE 或 ST-Link Utility 时会自动安装驱动
- 如果手动安装，去 ST 官网下载 ST-Link 驱动包
- 插上 ST-Link，设备管理器应出现「STMicroelectronics STLink dongle」
1.4 验证环境是否正常
环境搭没搭好，跑个简单程序就知道了。我习惯用 LED 闪烁来验证——代码简单，效果直观。
// 简单的GPIO测试代码
#include "stm32f1xx_hal.h"
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
int main(void)
{
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
while (1)
{
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500);
}
}把代码下载到板子里，如果 LED 以 0.5 秒间隔闪烁，说明你的调试环境已经搭建成功。如果没反应，别慌，按这个顺序排查：
- 检查调试器连接线是否松动
- 检查开发板供电是否正常
- 检查 IDE 中的调试器型号是否选对
- 检查驱动是否安装成功
1.5 本章知识体系
下面这张图帮你理清调试环境搭建的整体脉络：
调试环境搭建，说白了就是三件事：硬件选对、软件装好、驱动配通。每一步都有小坑，但只要你按流程走，最多半小时就能搞定。我刚开始学的时候，光装驱动就折腾了两天，现在回想起来，其实就是少装了一个 USB 驱动包。
环境搭好了，后面的事情就顺了。记住，调试环境是基础中的基础，别在这上面省时间。