STM32开发第一步：手把手教你用Keil5从零搭建工程
你是不是也经历过这样的时刻？买了块STM32最小系统板，装好了Keil5，满心期待地想点个LED，结果一新建工程就卡住了——“Keil5怎么创建新工程？”
别急。这几乎是每个嵌入式新手都会踩的第一个坑。
今天，我们就抛开那些晦涩的术语堆砌和模板化流程，像朋友聊天一样，一步步带你从零开始，在Keil5里完整构建一个能跑起来的STM32工程。不只是“怎么做”，更要讲清楚“为什么这么办”。
为什么是Keil5？它到底是个啥？
在讲怎么建工程之前，先搞明白我们手里这个工具的本质。
Keil5（正式名称为μVision5或MDK-ARM V5）不是简单的代码编辑器，而是一整套面向ARM Cortex-M系列微控制器的集成开发环境。你可以把它理解成一套“嵌入式开发工作台”：
- 写代码 → 编辑器
- 翻译代码 → Arm Compiler（支持AC5/AC6）
- 组织文件 → 工程管理器
- 下载程序 → Flash算法 + 调试驱动
- 单步调试 → 支持ST-Link、J-Link等硬件调试器
尤其对于STM32F1/F4这类经典系列，Keil5依然是许多企业项目和高校教学的首选平台，稳定性强、生态成熟，哪怕现在CubeIDE流行了，懂Keil仍是硬核技能。
✅ 小贴士：本文以STM32F103C8T6（俗称“蓝丸”）为例，但方法适用于所有STM32系列芯片。
第一步：安装好“弹药包”——DFP设备支持包
很多人忽略这一点，直接建工程后发现找不到外设定义或无法下载程序，根源就在于缺少Device Family Pack（简称DFP）。
操作步骤：
- 打开 Keil5 → 进入
Pack Installer（在线包管理器） - 在搜索栏输入
STM32F1 - 找到
Keil.STM32F1xx_DFP包，点击 Install
这个包会自动为你添加：
- 寄存器头文件（如stm32f10x.h）
- 启动文件模板（startup_xxx.s）
- Flash编程算法（用于烧录）
没有它，你的工程就像没装子弹的枪，看着挺像样，就是打不响。
第二步：真正开始——创建第一个工程
来吧，动手！
1. 新建工程
菜单栏选择：Project → New μVision Project
弹出对话框，选择工程保存路径，比如：D:\Projects\STM32_LED_Blink
命名工程为BlinkLED.uvprojx，点击保存。
接下来最关键一步来了：
2. 选对芯片型号！
系统会弹出 “Select Device for Target” 窗口。
输入STM32F103C8，从列表中准确选择：
STMicroelectronics → STM32F103C8
⚠️ 注意事项：
- 不要随便选“Generic”或其他封装相近的型号；
- 一旦选错，寄存器映射可能不同，导致初始化失败甚至死机。
确认后点击 OK，Keil5 就知道你要用哪款MCU了。
第三步：配置目标选项（魔术棒设置）
看到那个小魔术棒图标了吗？这是整个工程的核心配置入口。
双击打开Options for Target，进入多个标签页设置。
🎯 Target 标签页
- XTAL (MHz)：填上外部晶振频率，通常是
8.0MHz（如果你用的是8M晶振）。虽然不影响编译，但在仿真时会影响延时精度。 - Memory Model：保持默认 Small（适合大多数应用）
- Use MicroLIB：建议勾选！尤其是在裸机开发中使用
printf输出串口时，必须开启才能正常使用标准库函数。
🔧 Output 标签页
- 勾选Create HEX File：生成.hex文件，可用于ISP烧录。
- 设置输出目录（可改为
.\\Output），方便统一管理。
💡 C/C++ 标签页
这里是关键中的关键！
包含路径（Include Paths）：
点击“…”按钮添加以下路径（假设你已将CMSIS和SPL库放在工程目录下）：
.\Inc .\Src .\Libraries\CMSIS\Device\ST\STM32F10x\Include .\Libraries\CMSIS\CoreSupport .\Libraries\STM32F10x_StdPeriph_Driver\inc这些路径告诉编译器：“去这些地方找头文件”。
宏定义（Define）：
在同一页面填写：
USE_STDPERIPH_DRIVER, STM32F10X_MD解释一下这两个宏的意义：
| 宏 | 作用 |
|---|---|
USE_STDPERIPH_DRIVER | 启用标准外设库（SPL），让编译器加载相关驱动函数 |
STM32F10X_MD | 表示芯片Flash容量为中等密度（Medium Density），对应64KB Flash（如C8T6） |
📌 如果你用了大容量芯片（如128KB以上），应改为STM32F10X_HD，否则启动文件链接错误！
第四步：加入必要的源文件
现在工程骨架有了，但还差“血肉”——关键源文件还没加进去。
右键左侧 Project 面板中的Source Group 1→Add Existing Files...
依次添加以下文件：
1. 启动文件（Startup File）
路径通常位于：
\Libraries\CMSIS\Device\ST\STM32F10x\Source\arm\startup_stm32f10x_md.s✅ 必须根据 Flash 大小选择正确的启动文件：
-ld：小容量（≤32KB）
-md：中容量（≤128KB） ← 我们的C8T6属于此类
-hd：大容量（>128KB）
❌ 错误示例：给C8T6用了
hd版本 → 编译通过，但运行异常，因为向量表大小不对！
2. 系统初始化文件
添加：
\Libraries\CMSIS\Device\ST\STM32F10x\Source\system_stm32f10x.c这个文件实现了SystemInit()函数，负责配置系统时钟（默认72MHz主频），非常重要。
3. 外设库源文件（使用SPL时）
如果你打算用标准外设库，还需要手动添加对应的.c文件，例如控制GPIO就需要：
\Libraries\STM32F10x_StdPeriph_Driver\src\stm32f10x_gpio.c \Libraries\STM32F10x_StdPeriph_Driver\src\stm32f10x_rcc.c当然，也可以一次性把整个src文件夹都加进来，便于后续扩展。
第五步：写你的第一行主函数代码
新建一个main.c文件，内容如下：
#include "stm32f10x.h" #include "stm32f10x_gpio.h" #include "stm32f10x_rcc.h" // 简单延时函数 static void Delay(volatile uint32_t count) { while(count--); } int main(void) { // 初始化系统时钟（72MHz） SystemInit(); // 开启GPIOC时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); // 配置PC13引脚为推挽输出 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz; GPIO_Init(GPIOC, &GPIO_InitStructure); // 主循环：LED闪烁 while (1) { GPIO_SetBits(GPIOC, GPIO_Pin_13); // LED灭（共阳接法） Delay(0x7FFFFF); GPIO_ResetBits(GPIOC, GPIO_Pin_13); // LED亮 Delay(0x7FFFFF); } }💡 说明：
- PC13通常连接板载LED，低电平点亮（共阳极设计）
-Delay()是粗略延时，实际项目建议用SysTick定时器替代
将此文件也加入工程中。
第六步：编译 & 下载前的最后检查
点击“Build”按钮（锤子图标），如果一切顺利，你会看到：
"BlinkLED" - 0 Error(s), 0 Warning(s).
如果有报错，常见原因如下：
| 报错类型 | 可能原因 | 解决方案 |
|---|---|---|
undefined symbol GPIO_Init | 未添加stm32f10x_gpio.c | 检查是否已将其加入工程 |
identifier "RCC_APB2Periph_GPIOC" is undefined | 未定义USE_STDPERIPH_DRIVER | 回到C/C++标签页检查宏定义 |
cannot open source file "stm32f10x.h" | 包含路径错误 | 检查Include Paths是否正确指向头文件目录 |
✅ 成功编译后，下一步就是下载！
第七步：连接ST-Link，烧录程序
使用SWD接口连接：
- ST-Link → MCU
- SWCLK → PA14
- SWDIO → PA13
- GND → GND
- VCC → 3.3V（可选供电）点击“Download”按钮（向下箭头图标）
若提示“Programming Algorithm not found”，说明缺Flash算法。
解决办法：
- 点击魔术棒 → Utilities → Settings
- 在Flash Download标签页，点击“Add” → 选择对应算法（如 STM32F10x 64KB）
再次下载，成功后程序即写入Flash。
常见陷阱与避坑指南
⚠️ 问题1：程序下载成功，但LED不闪？
- 检查BOOT0引脚是否拉低（正常模式运行Flash程序）
- 检查PC13是否确实是LED控制引脚（查阅原理图）
- 检查电源是否稳定，复位电路是否正常
⚠️ 问题2：断电重启后程序不运行？
- 大概率是你进入了某种异常状态（如HardFault）
- 可尝试启用
Debug模式，单步跟踪执行流程 - 或者改用更稳定的HAL库 + STM32CubeMX辅助生成代码
⚠️ 问题3：换电脑打开工程后路径失效？
- 原因：使用了绝对路径
- 解决方案：全部使用相对路径（如
..\Lib\...），确保工程可移植
工程结构推荐：让你的项目更专业
一个好的工程组织方式能让后期维护事半功倍。建议采用如下目录结构：
BlinkLED/ ├── Project/ ← Keil工程文件 (.uvprojx) ├── Output/ ← 输出文件 (HEX/BIN/OBJ) ├── Listings/ ← 列表文件 (.lst) ├── Inc/ ← 头文件 │ └── main.h ├── Src/ ← 用户源码 │ └── main.c ├── Libraries/ │ ├── CMSIS/ ← Cortex核心支持 │ └── STM32F10x_StdPeriph_Driver/ ← SPL库 └── Startup/ └── startup_stm32f10x_md.s这样不仅清晰，还能轻松纳入Git版本控制。
📦 提示：
.uvoptx和.build_log.htm属于用户本地配置，建议加入.gitignore，不要提交到仓库。
结语：这只是起点
看到LED一闪一闪，或许你觉得不过如此。但请记住：每一个伟大的系统，都是从点亮第一颗LED开始的。
你现在掌握的不仅仅是“Keil5怎么创建新工程”，更是嵌入式开发最底层的逻辑框架——
- 如何组织代码
- 如何配置环境
- 如何理解启动流程
- 如何排查常见故障
这些能力，远比学会某个图形化工具更重要。
未来你可以尝试：
- 移植FreeRTOS实现多任务
- 使用ADC读取传感器数据
- 通过UART发送调试信息
- 配合STM32CubeMX自动生成初始化代码
但无论走得多远，请记得回头看看这个亲手搭建的第一个工程。它是你嵌入式旅程的原点。
如果你在实操过程中遇到任何问题——比如编译通不过、下载失败、LED就是不亮——欢迎留言交流，我们一起debug到底。
