STM32开发入门必看：Keil5编译环境搭建操作指南
STM32开发从零起步：手把手教你搭建Keil5开发环境
你是不是刚接触STM32，面对一堆安装包和报错信息感到无从下手？
是不是下载了Keil却编译失败、烧录失败，连“Hello World”都跑不起来？
别急。每一个STM32开发者，几乎都经历过这样的阶段——不是驱动装不上，就是头文件找不到，再不然就是ST-Link连不上目标板。这些问题看似琐碎，却足以让初学者望而却步。
今天，我们就来彻底拆解Keil5开发环境的搭建全过程，用最贴近实战的方式，带你绕过所有“新手坑”，真正把工具掌握在自己手里。
为什么是Keil5？它到底强在哪？
在开始动手之前，先搞清楚一件事：我们为什么要用Keil5来做STM32开发？
市面上能写STM32代码的IDE不少，比如IAR、STM32CubeIDE、VS Code + PlatformIO……但Keil µVision5（简称Keil5）依然是许多企业、高校和资深工程师的首选。原因很简单：
- 稳定可靠：十几年的老牌工具，Bug少，兼容性好；
- 调试强大：单步执行、变量监视、内存查看、寄存器映射一应俱全；
- 生态成熟：官方支持完善，资料多，出问题容易查到解决方案；
- 贴近底层：适合学习MCU启动流程、中断机制、内存布局等核心知识。
更重要的是，Keil5对ARM架构原生支持极佳，配合ST官方推出的设备支持包（DFP），可以做到“选好芯片 → 自动生成工程框架 → 直接开干”。
所以，哪怕你现在只是想点亮一个LED，掌握Keil5也是迈向专业嵌入式开发的第一步。
搭建环境三件套：软件 + 驱动 + 下载器
要让STM32跑起来，你需要三个关键组件协同工作：
- Keil MDK（开发环境）
- STM32 Device Family Pack（DFP，设备支持包）
- ST-Link（硬件调试下载器）及驱动
下面我们一个一个来搞定。
第一步：安装Keil MDK —— 开发的大本营
前往 Keil官网 下载MDK-ARM安装包（目前最新版本建议使用 v5.37 或以上）。
⚠️ 提示：Keil有免费版，但编译限制为32KB代码大小。对于大多数STM32F1/F4系列芯片来说够用，但如果项目较大，需要申请试用授权或购买正式License。
安装过程非常简单：
- 双击.exe文件，一路Next；
- 安装路径尽量不要含中文或空格（例如C:\Keil_v5\）；
- 安装过程中会提示是否安装“Device Family Packs”，可暂时跳过，后面手动更新更灵活。
安装完成后打开 Keil µVision5，你会看到一个清爽的界面——这是你未来写代码、调程序的主要战场。
第二步：安装STM32设备支持包（DFP）
这是很多人卡住的地方：明明写了代码，为什么提示fatal error: 'stm32f1xx.h' No such file or directory？
答案就是：你没装对应的DFP！
什么是DFP？
DFP（Device Family Pack）是由Keil联合ST官方发布的设备支持扩展包，里面包含了某个系列STM32所需的：
- 寄存器定义头文件（如
stm32f1xx.h） - 启动文件（
startup_stm32f103xe.s） - Flash编程算法
- SVD外设描述文件（用于寄存器视图调试）
没有它，Keil就不知道你的STM32长什么样，自然没法编译。
如何安装？
- 打开 Keil →
Pack Installer（菜单栏Tools > Pack Installer）； - 在左侧搜索栏输入 “STM32F1” 或你使用的型号；
- 找到对应系列的DFP（例如
STM32F1xx_DFP），点击右侧的Install； - 等待下载安装完成（需联网）。
✅ 安装成功后，在新建工程时就能选择具体的MCU型号了。
🛠 小技巧：如果你离线部署（比如实验室不能上网），可以提前从 Keil官网 下载
.pack文件，然后通过Import导入。
第三步：搞定ST-Link与驱动
现在软件齐了，接下来是硬件部分。
ST-Link是ST自家的调试下载工具，常见形式有两种：
- 独立模块（ST-Link/V2、V3）
- 集成在Nucleo/Discovery开发板上的“On-Board ST-Link”
它通过USB连接电脑，再用SWD接口连接目标STM32芯片，实现程序烧录和在线调试。
驱动安装
现代Windows系统通常能自动识别ST-Link，但为了保险起见，建议手动确认：
- 连接ST-Link到PC；
- 打开设备管理器（Win+X → 设备管理器）；
- 查看是否有以下设备出现：
-STMicroelectronics STLink Virtual COM Port
-STMicroelectronics STLink Debugger
如果有黄色感叹号，说明驱动未正确安装。
👉 解决方案：
- 前往 ST官网下载STSW-LINK009 驱动包；
- 解压后以管理员身份运行安装程序；
- 或者使用Keil自带的驱动安装功能（安装MDK时勾选“Install ULINK Pro Drivers”也会包含ST-Link支持）。
接线方式（SWD模式）
ST-Link与目标板连接只需4根线：
| ST-Link | 目标板 |
|---|---|
| GND | GND |
| SWDIO | PA13 / SWDIO |
| SWCLK | PA14 / SWCLK |
| 3.3V | VCC（可选供电） |
⚠️ 注意事项：
- 不要接反电源！GND必须共地；
- 如果目标板已有独立电源，请勿同时接ST-Link的3.3V，避免电源冲突；
- BOOT0引脚应接地（正常运行模式），否则无法进入用户Flash程序。
创建第一个工程：从零到“Build Succeeded”
准备工作就绪，我们来创建一个最简单的工程，验证整个环境是否正常。
步骤1：新建工程
- 打开 Keil →
Project > New uVision Project； - 选择保存路径，命名工程（如
LED_Blink）； - 弹出“Select Device”窗口，输入你使用的MCU型号（如
STM32F103C8T6）； - 展开列表，选择对应器件，点击OK；
- Keil会询问是否复制标准启动文件，选择“否”（因为我们用DFP自动管理）。
步骤2：配置环境与添加文件
- 右键左侧项目面板中的
Source Group 1→Add New Item to Group...； - 选择
C File (.c)，命名为main.c； - 输入一段最简代码：
#include "stm32f1xx.h" void delay(volatile uint32_t count) { while(count--); } int main(void) { // 使能GPIOA时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPAEN; // 配置PA5为推挽输出（LED常用引脚） GPIOA->CRL &= ~GPIO_CRL_MODE5; GPIOA->CRL |= GPIO_CRL_MODE5_1; // 输出模式，最大速度2MHz GPIOA->CRL &= ~GPIO_CRL_CNF5; // 推挽输出 while (1) { GPIOA->BSRR = GPIO_BSRR_BR5; // PA5输出低电平（假设LED共阳） delay(0xFFFFF); GPIOA->BSRR = GPIO_BSRR_BS5; // PA5输出高电平 delay(0xFFFFF); } }这段代码直接操作寄存器控制GPIO，不依赖任何库函数，非常适合测试基础环境。
步骤3：设置编译选项
进入Project > Options for Target：
Output 标签页：
- 勾选Create HEX File（方便后续使用其他工具烧录）C/C++ 标签页：
- Define 中添加：STM32F103xB（根据实际芯片选择，C8T6属于中密度产品）
- Include Paths 添加：.\\RTE\\Device\\STM32F103xB（Keil会自动补全路径）Debug 标签页：
- 选择右侧的ST-Link Debugger
- 点击Settings→Flash Download→ 勾选Download to Flash
- 点击Add，选择匹配的Flash算法（如STM32F1xx Medium-density Flash）Utilities 标签页：
- 勾选Use Debug Driver
- 确保“Update Target before Debugging”启用
点击OK保存设置。
步骤4：编译 & 下载
按下快捷键F7编译工程。
如果一切顺利，底部Build窗口会出现：
".\Objects\LED_Blink.axf" - 0 Error(s), 0 Warning(s).恭喜！编译通过！
接着按下F8（或点击“Load”按钮），Keil会将程序下载到STM32的Flash中。
下载成功后，点击绿色“Start/Stop Debug Session”按钮进入调试模式，按F5全速运行，你应该能看到连接在PA5上的LED开始闪烁！
常见问题与避坑指南
即使按照上述步骤操作，仍可能遇到一些典型问题。以下是高频“踩坑点”及其解决方案：
❌ 问题1：编译报错 “’stm32f1xx.h’ No such file or directory”
原因：头文件路径未正确添加，或DFP未安装。
解决方法：
- 打开 Pack Installer，确认已安装STM32F1xx_DFP；
- 检查Options > C/C++ > Include Paths是否包含.\\RTE\\Device\\STM32F103xx；
- 若路径显示红色叉，说明不存在，尝试重新安装DFP。
❌ 问题2：下载时报错 “No Algorithm found for specified range”
原因：未添加正确的Flash编程算法。
解决方法：
- 进入Options > Utilities > Settings > Flash Download；
- 点击Add，根据芯片容量选择对应算法：
- 小容量：< 32KB → Low-density
- 中容量：32~128KB → Medium-density
- 大容量：>128KB → High-density
- 地址范围必须是0x08000000开始。
❌ 问题3：无法连接目标 “Cannot access target”
可能原因及排查步骤：
| 检查项 | 操作 |
|---|---|
| ✅ ST-Link是否被识别 | 设备管理器中查看是否有STLink设备 |
| ✅ 目标板是否上电 | 测量VDD-GND间电压是否为3.3V |
| ✅ SWD接线是否正确 | 检查SWCLK、SWDIO、GND是否松动 |
| ✅ BOOT0是否接地 | 必须为低电平才能运行用户程序 |
| ✅ 是否启用了PC-Sleep禁用SWD | 某些低功耗设计会关闭调试接口 |
👉 终极测试法：使用 ST-Link Utility 工具尝试连接，若能读取芯片ID，则说明硬件连接正常。
✅ 高阶建议：提升开发效率的小技巧
使用RTE（Run-Time Environment）
在Manage Run-Time Environment中启用CMSIS-Core、Device Startup等模块，Keil会自动帮你加入启动文件和系统初始化代码。统一团队开发环境
团队协作时，约定Keil版本、Compiler版本（推荐AC6）、DFP版本，避免“我这边能编译你那边报错”。开启严格警告等级
在C/C++选项中添加--strict_warnings --diag_warning=1，有助于发现潜在错误。备份Flash算法文件
路径一般位于.\ARM\Flash\目录下，重装系统前记得打包保存。
写在最后：工具只是起点，思维才是核心
搭建Keil5环境，看起来只是安装几个软件、插根线的事，但它背后涉及的知识却是嵌入式开发的基石：
- 你知道为什么需要启动文件吗？
- 你知道分散加载文件（
.sct）是如何决定代码放在哪里的吗？ - 你知道ST-Link是如何通过SWD协议访问CPU内核的吗？
这些，才是真正的硬核能力。
当你不再满足于“点一下就能下载”，而是开始思考“它是怎么工作的”，你就已经踏上了成为嵌入式工程师的正轨。
所以，别小看这个“入门教程”。
每一个大师，都是从点亮第一颗LED开始的。
如果你在搭建过程中遇到了其他问题，欢迎留言交流。下一篇文章我们将深入探讨：如何使用HAL库快速驱动GPIO、UART、TIM，并实现串口打印日志。
一起进步，不见不散。