第2章开发环境搭建

2、开发环境搭建：Keil MDK安装与破解、STM32CubeMX配置、HAL库与标准外设库对比、第一个LED工程

说实话，做嵌入式开发这么多年，我见过太多新手在环境搭建这一步就卡住了。不是装不上，就是装上了跑不起来。嗯，今天咱们就把这事彻底捋清楚。

我个人习惯把开发环境比作「厨房」——工具顺手了，做菜才快。STM32的开发环境，说白了就三样东西：编译器（Keil MDK）、配置工具（CubeMX）、以及你选用的库（HAL或标准库）。咱们一个一个来。

2.1 Keil MDK安装与破解

Keil MDK，ARM开发的老牌工具了。我最早用Keil还是大学做C51的时候，那时候界面还是灰不溜秋的。现在的MDK v5已经漂亮多了。

安装步骤：

去ARM官网下载MDK-ARM安装包（建议v5.38或更新版本）
双击安装，一路Next。注意安装路径不要有中文
安装完成后，打开Keil，会提示注册
以管理员身份运行Keil，进入 File → License Management
使用注册机生成激活码（注意：注册机需要以管理员权限运行）

⚠️ 避坑指南： 我曾经因为忘记以管理员身份运行注册机，折腾了整整一下午。生成的CID死活不对。后来才发现是权限问题。记住：Keil和注册机都要以管理员身份运行。

关于编译器版本：

Keil MDK v5默认带的是AC5编译器。但STM32CubeMX生成的代码，有时候用AC6编译更快。我个人建议：新项目直接用AC6，编译速度能快30%左右。怎么切换？在工程选项的 Target 标签页里，把 ARM Compiler 改成 "Use default compiler version 6" 就行。

2.2 STM32CubeMX配置

STM32CubeMX，ST官方出的图形化配置工具。说实话，这玩意儿刚出来的时候我挺抵触的——总觉得图形化配置不靠谱。后来真香了。你想想看，几百个寄存器，手动配一遍得花多少时间？

基本配置流程：

打开CubeMX，点击 "New Project"
在Part Number搜索框输入你的芯片型号，比如STM32F103C8
双击选中芯片，进入配置界面
配置时钟树（RCC）—— 我一般先配HSE，再配PLL
配置GPIO引脚 —— 点一下引脚，选功能
配置Debug接口 —— 记得把SWD打开，不然下次烧录就麻烦了
点击 "Project Manager" 标签，设置工程名、路径、IDE类型（选MDK-ARM）
点击 "GENERATE CODE" 生成代码

💡 小技巧： CubeMX生成的代码默认放在 "Src" 和 "Inc" 文件夹里。我习惯把用户代码写在 "/* USER CODE BEGIN */" 和 "/* USER CODE END */" 之间。这样下次重新生成代码时，你的代码不会被覆盖。

时钟树配置这块，很多人容易搞晕。其实核心就一句话：先确定HSE频率，再算PLL倍频，最后看APB1/APB2分频。以STM32F103为例，HSE用8MHz晶振，PLL倍频到72MHz，APB1最高36MHz，APB2最高72MHz。记住这个数，够用。

2.3 HAL库与标准外设库对比

这个问题，几乎每个初学者都会问：到底学HAL库还是标准库？

我直接说结论：新项目用HAL库，老项目维护用标准库。

对比项	HAL库	标准外设库
代码风格	面向对象，分层清晰	面向过程，直接操作寄存器
可移植性	强，换芯片只需改配置	弱，换芯片基本重写
代码量	较大，有冗余	精简，效率高
学习曲线	平缓，CubeMX生成大部分代码	陡峭，需要熟悉寄存器
ST官方支持	主力维护，持续更新	已停止更新
适合场景	新产品、复杂外设、快速开发	资源受限、老项目维护、学习原理

为什么我推荐HAL库？说白了，ST官方已经停止更新标准库了。你想想看，一个不再维护的库，出了bug谁管？而且HAL库配合CubeMX，开发效率确实高。我在做智能家居网关项目时，用HAL库+FreeRTOS，两周就把所有外设驱动调通了。

但标准库也有它的价值。如果你想深入理解STM32的底层原理，标准库是很好的学习材料。它直接操作寄存器，你能看到每个位是怎么设置的。HAL库封装得太好了，有时候反而让你「知其然不知其所以然」。

  我的建议：
  初学者先用HAL库把项目跑起来，建立信心。然后回头看看标准库的源码，理解底层原理。两条腿走路，稳。

2.4 第一个LED工程

好了，理论说完了，咱们动手。第一个工程，当然是点灯。这几乎是嵌入式界的「Hello World」。

步骤一：CubeMX配置

新建工程，选STM32F103C8
在Pinout视图里，找到PC13引脚（板载LED通常接这个脚）
右键点击PC13，选 "GPIO_Output"
在Configuration里，把GPIO输出模式设为 "Push-Pull"，速度设为 "Low"
时钟树：HSE 8MHz，PLL倍频到72MHz
Project Manager：工程名 "LED_Test"，IDE选 "MDK-ARM"
生成代码

步骤二：编写用户代码

打开Keil工程，在 main.c 的 USER CODE 区域添加代码：

/* USER CODE BEGIN 2 */
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET);  // 点亮LED
/* USER CODE END 2 */

/* USER CODE BEGIN WHILE */
while (1)
{
  HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);  // 翻转LED
  HAL_Delay(500);                           // 延时500ms
/* USER CODE END WHILE */

/* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */

步骤三：编译下载

点击 "Build" 按钮（或者按F7），编译工程
连接ST-Link下载器
点击 "Download" 按钮（或者按F8），烧录程序
按下复位键，观察LED是否以1秒周期闪烁

⚠️ 常见问题：

编译报错 "Error: L6218E" —— 多半是HAL库文件没加全。检查一下工程里有没有 stm32f1xx_hal_gpio.c 和 stm32f1xx_hal_rcc.c
下载失败 "No target connected" —— 检查ST-Link接线，或者试试按住复位键再点下载
LED不亮 —— 先量一下引脚电平。如果PC13是3.3V，说明配置成高电平有效了。有些板子是低电平点亮，注意极性

我记得第一次调LED的时候，焊反了LED的正负极，折腾了半小时才发现。嗯，从那以后我每次都会先看原理图确认引脚极性。

代码写完了，编译通过了，LED闪起来了。恭喜你，你已经完成了STM32开发的第一个里程碑。这个看似简单的点灯程序，背后涉及了GPIO配置、时钟使能、HAL库调用、编译下载整个流程。后面的所有项目，都是在这个基础上叠加的。

💡 扩展思考： 试试把延时从500ms改成100ms，看看LED闪烁频率的变化。再试试用定时器中断来实现精确延时——这就是下一阶段要学的内容了。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录

2、开发环境搭建：Keil MDK安装与破解、STM32CubeMX配置、HAL库与标准外设库对比、第一个LED工程

2.1 Keil MDK安装与破解

2.2 STM32CubeMX配置

2.3 HAL库与标准外设库对比

2.4 第一个LED工程