3. STM32开发环境搭建：Keil MDK安装、STM32CubeMX安装、HAL库介绍、第一个LED工程创建与下载
好，咱们正式开始动手了。这一章我带你把开发环境搭起来。很多初学者卡在这一步，装了一堆软件，结果点不亮一个LED。别急，跟着我的节奏来，半小时内让板子上的灯闪起来。
3.1 开发工具链概览
做STM32开发，你至少需要三样东西：编译器、芯片配置工具、调试下载器。我个人的习惯是：Keil MDK 做编译和调试，STM32CubeMX 做外设初始化代码生成，ST-Link 或者 J-Link 把程序烧进去。这三者配合起来，效率最高。
核心工具链关系图
3.2 Keil MDK 安装与破解
Keil MDK 是 ARM 公司出的 IDE，专门用来编译 Cortex-M 系列芯片。说实话，它的界面有点老气，但稳定性和编译效率没得说。
3.2.1 下载与安装步骤
- 去官网下载 MDK-ARM：搜索 "Keil MDK download"，找到最新版本。目前主流是 MDK v5.38 或 v5.39。
- 运行安装包：一路 Next，注意安装路径不要有中文。我习惯装到
C:\Keil_v5。 - 安装器件包：安装完成后，打开 Keil，点击
Pack Installer，找到你的芯片型号。比如 STM32F103C8，勾上对应的 Device Family Pack。 - 注册（你懂的）：用管理员身份运行 Keil，点击
File - License Management，输入 CID，用注册机生成 License，粘贴进去。
⚠️ 我曾经踩过的坑： 安装路径带空格或中文，导致编译时头文件找不到。还有一次，忘记安装器件包，编译报错说找不到芯片定义。记住：先装 Keil，再装 Pack，顺序别搞反。
3.3 STM32CubeMX 安装
STM32CubeMX 是 ST 官方出的图形化配置工具。你想想看，以前配一个定时器要翻几百页数据手册，现在鼠标点几下就搞定了。我个人觉得，这是 ST 做的最良心的一款工具。
3.3.1 安装要点
- 需要 Java 运行环境：CubeMX 基于 Java 开发，所以你得先装 JRE 或 JDK。我建议装 JDK 11 以上版本。
- 下载地址：ST 官网搜索 "STM32CubeMX"，下载最新安装包。
- 安装过程：双击安装，选择安装路径。安装完后，它会自动更新固件包库。
- 固件包管理：第一次打开时，点击
Help - Manage embedded software packages，下载你需要的芯片系列。比如 STM32F1 系列，大概 300MB 左右。
💡 我的小技巧： CubeMX 生成的代码默认放在 C:\Users\用户名\STM32Cube\Repository。如果你 C 盘空间紧张，可以在 Help - Updater Settings 里改路径。我一般改到 D 盘。
3.4 HAL 库介绍
HAL 库，全称 Hardware Abstraction Layer，硬件抽象层。说白了，就是 ST 官方帮你封装好的驱动库。你不需要直接操作寄存器，调用函数就能控制外设。
3.4.1 HAL 库 vs 标准外设库 vs LL 库
| 对比项 | HAL 库 | 标准外设库 | LL 库 |
|---|---|---|---|
| 封装层次 | 高（面向对象风格） | 中（面向寄存器） | 低（接近寄存器） |
| 代码量 | 较大 | 中等 | 小 |
| 移植性 | 强（跨系列通用） | 弱（不同系列不通用） | 中等 |
| 学习曲线 | 平缓 | 较陡 | 陡 |
| 适用场景 | 快速原型、复杂外设 | 老项目维护 | 对性能要求高的场合 |
我个人的建议是：新手无脑选 HAL 库。等你把 HAL 库用熟了，再去看 LL 库或者直接操作寄存器。我在项目中遇到过一位同事，上来就搞寄存器，结果一个 PWM 配置搞了三天还没搞定。用 HAL 库，十分钟就调通了。
3.4.2 HAL 库的核心文件结构
当你用 CubeMX 生成一个工程后，会看到这些关键文件：
stm32f1xx_hal.h：主头文件，包含所有外设的 HAL 驱动声明。stm32f1xx_hal_gpio.c：GPIO 驱动，控制引脚输入输出。stm32f1xx_hal_tim.c：定时器驱动，PWM、输入捕获全靠它。stm32f1xx_hal_msp.c：MCU 支持包，负责引脚映射和时钟配置。main.c：你的用户代码入口。
记住这个原则： HAL 库的 API 命名非常规律。比如初始化函数叫 HAL_XXX_Init()，启动函数叫 HAL_XXX_Start()，中断回调叫 HAL_XXX_IRQHandler()。你只要记住这个规律，查手册都省了。
3.5 第一个 LED 工程创建与下载
好，理论说完了，咱们来点实际的。用 CubeMX 生成一个工程，让板子上的 LED 闪烁起来。我以 STM32F103C8T6 最小系统板为例，LED 接在 PC13 引脚（这是最常见的板载 LED 引脚）。
3.5.1 使用 CubeMX 生成初始化代码
- 新建工程：打开 CubeMX，点击
New Project，在Part Number里搜索STM32F103C8，双击选中。 - 配置时钟：切换到
Clock Configuration标签页。把 HSE 设为 8MHz（外部晶振），PLL 倍频到 72MHz。嗯，这里要注意：HCLK 不要超过 72MHz，否则芯片会跑飞。 - 配置 GPIO：在
Pinout & Configuration视图里，找到 PC13 引脚，左键点击，选择GPIO_Output。 - 配置 GPIO 参数：在右侧
Configuration面板里，找到GPIO标签，把 PC13 的Maximum output speed设为Low，User Label改成LED。这样生成的代码里引脚名就是LED_Pin，方便阅读。 - 生成代码：点击
Project - Generate Code，选择MDK-ARM V5工具链，点击Generate。几秒钟后，工程就生成了。
💡 避坑指南： 生成代码时，记得勾选 Generate peripheral initialization as a pair of .c/.h files per peripheral。这样每个外设单独一个文件，后期维护方便。我曾经偷懒没勾，结果所有初始化代码全挤在 main.c 里，改个参数要找半天。
3.5.2 在 Keil 中编写 LED 闪烁代码
生成完成后，点击 Open Project，Keil 会自动打开。找到 main.c，在 while(1) 循环里添加以下代码：
/* 用户代码开始处 */
while (1)
{
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); // 翻转 LED 引脚电平
HAL_Delay(500); // 延时 500ms
}
/* 用户代码结束处 */就这么两行。HAL_GPIO_TogglePin 是 HAL 库提供的翻转函数，比你自己写寄存器方便多了。HAL_Delay 是基于 SysTick 的毫秒级延时，精度够用。
3.5.3 编译与下载
- 编译：点击 Keil 工具栏的
Build按钮（或者按 F7）。如果没报错，说明代码没问题。 - 配置下载器：点击
Project - Options for Target，在Debug标签页里选择ST-Link Debugger，然后点击Settings，确认 SWD 模式能识别到芯片。 - 下载：点击
Load按钮（或者按 F8）。下载完成后，板子上的 LED 应该开始以 1 秒的频率闪烁。
⚠️ 如果下载失败，检查这几点：
- ST-Link 驱动装了吗？没装的话去 ST 官网下载
ST-Link USB driver。 - 接线对吗？SWD 接口只需要 SWDIO、SWCLK、GND 三根线，VCC 可以不用接（目标板自己供电）。
- 芯片被锁了吗？如果之前烧了错误的代码，芯片可能进入低功耗模式。按住复位键再点下载，松手即可。
3.6 本章小结
到这，你的开发环境就搭好了。Keil 负责编译，CubeMX 负责配置，HAL 库帮你省掉大量寄存器操作。第一个 LED 工程虽然简单，但它是你进入嵌入式世界的第一步。后面的定时器、PWM、电机控制，都是在这个基础上叠加的。
记住：环境搭好了，后面的事就顺了。如果卡在哪一步，别硬扛，回头看看是不是驱动没装或者 Pack 没装。我当年第一次搭环境，折腾了一下午，最后发现是 USB 线只能充电不能传数据。嗯，这种低级错误，你肯定不会再犯了。