KEIL5与STM32F103开发入门：从环境配置到LED闪烁实战

2026/8/3 8:16:58 拓冰建站浏览量

1. 从零开始：为什么选择KEIL5+STM32F103组合

十年前我第一次接触STM32开发时，MDK-ARM（KEIL5的前身）和STM32F103的组合就像咖啡配奶精一样自然。如今虽然有了更多选择，但这个经典组合依然是嵌入式新手的首选起跑线。KEIL5的代码补全和调试功能对初学者特别友好，而STM32F103C8T6这颗被戏称为"电子工程师的Hello World"的芯片，以其20元左右的亲民价格和丰富资源，成为了无数人嵌入式开发的启蒙老师。

最近帮学弟解决工程配置问题时发现，虽然网上教程很多，但要么是过时的KEIL4版本，要么直接跳过了关键配置细节。这次我就用最新的KEIL5.36版本，带大家完整走一遍工程创建流程，重点讲解那些容易踩坑的配置项。我们将从软件安装开始，直到生成第一个闪烁LED的hex文件，过程中会特别说明：

编译器版本选择的门道（为什么默认的Compiler 5可能报错）
那些容易被忽略的魔术棒设置（比如微库使用与否的区别）
如何优雅地管理外设库文件（避免工程目录变成垃圾场）

小贴士：建议使用STM32F103C8T6最小系统板进行练习，这种蓝色小板子在电子市场随处可见，自带USB转串口和复位电路，特别适合新手实验。

2. 环境准备：KEIL5安装与芯片支持包配置

2.1 KEIL5安装避坑指南

官网下载MDK-Arm时要注意，532MB的在线安装包经常断连，建议直接下载1.5GB的完整包。安装路径切记不要有中文和空格，我习惯放在C:\Keil_v5这样简单的路径下。安装完成后别急着打开，先以管理员身份运行注册机（这个敏感话题我们点到为止）。

安装完成后有个关键操作：打开Pack Installer（工具栏那个彩色小盒子图标），搜索并安装STM32F1xx_DFP最新支持包。这里有个隐藏坑点——不同版本的DFP包对固件库的支持程度不同，建议选择2.3.0版本，这个版本对标准外设库兼容性最好。

2.2 编译器版本的选择策略

在Project菜单的Manage→Project Items里，有个影响深远的选项：Use Default Compiler Version 5。很多新手遇到的"target uses arm-compiler 'default compiler version 5' which..."警告就是源于这里。我的建议是：

对于学习标准库开发，选择AC5编译器（即Compiler 5）
如果要用HAL库或后续升级到STM32新型号，建议切到AC6
遇到奇怪的语法报错时，试试切换编译器版本

实测发现：AC6对C99标准支持更好，但某些标准库函数需要额外配置。新手可以先用AC5减少麻烦。

3. 工程骨架搭建：从空白项目到可编译框架

3.1 项目创建基础步骤

点击Project→New μVision Project，选择空目录并命名（建议用英文）。设备选择时输入STM32F103C8，注意区分不同封装：

48脚选STM32F103C8
64脚选STM32F103RC
144脚选STM32F103ZE

创建完成后立即保存工程（Ctrl+Shift+S），我习惯采用这样的目录结构：

Project/ ├── CMSIS/ // 内核相关文件 ├── FWlib/ // 标准外设库 ├── User/ // 用户代码 │ ├── main.c │ └── stm32f10x_conf.h └── Output/ // 生成文件

3.2 文件添加与路径配置

右键Target1选择Manage Project Items，创建上述目录结构。然后需要添加三类核心文件：

启动文件：CMSIS/startup_stm32f10x_md.s（中容量设备）
库文件：FWlib/src下的所有.c文件
头文件路径：必须包含CMSIS、FWlib/inc和User目录

关键技巧：在Options for Target→C/C++选项卡中，Define栏要填写：USE_STDPERIPH_DRIVER,STM32F10X_MD

这个预处理定义直接影响标准库的编译条件，其中STM32F10X_MD要根据芯片容量选择：

LD：小容量
MD：中容量（如F103C8T6）
HD：大容量

4. 系统时钟与调试配置

4.1 时钟树配置要点

在User目录新建system_stm32f10x.c文件（可从库例程复制），重点修改两个参数：

#define SYSCLK_FREQ_72MHz 72000000 #define HSE_VALUE ((uint32_t)8000000) // 外部晶振频率

在Options for Target→Debug选项卡，选择你的调试器（比如ST-Link Debugger），然后点击Settings：

Port选SW
Max Clock调到1MHz以内
勾选Reset and Run

4.2 微库使用的取舍

在魔法棒→Target选项卡底部，有个Use MicroLIB选项。这个微库可以减小代码体积，但会导致printf无法正常输出到串口。我的建议是：

调试阶段：不勾选，用标准库方便调试输出
发布阶段：勾选以节省空间，此时需要重定向fputc

重定向示例代码（放在main.c）：

#ifdef __GNUC__ #define PUTCHAR_PROTOTYPE int __io_putchar(int ch) #else #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f) #endif PUTCHAR_PROTOTYPE { USART_SendData(USART1, (uint8_t)ch); while(USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); return ch; }

5. 第一个LED闪烁工程实战

5.1 GPIO初始化代码详解

在User/main.c中编写核心控制逻辑：

#include "stm32f10x.h" void Delay(uint32_t nCount) { for(; nCount != 0; nCount--); } int main(void) { GPIO_InitTypeDef GPIO_InitStructure; // 开启GPIOB时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // 配置PB12为推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_12; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); while(1) { GPIO_SetBits(GPIOB, GPIO_Pin_12); Delay(0xFFFFF); GPIO_ResetBits(GPIOB, GPIO_Pin_12); Delay(0xFFFFF); } }

5.2 编译与下载技巧

点击Rebuild按钮后，常见问题及解决方案：

报错"..\cmsis\core_cm3.h(147): error: #5: cannot open source"：
- 检查头文件路径是否包含CMSIS目录
- 确认工程目录没有中文或特殊字符
下载时报错"No ULINK Device found"：
- 确认调试器驱动已安装
- 检查Options for Target→Debug配置
程序下载后不运行：
- 检查BOOT0引脚是否接地
- 确认Debug设置勾选了Reset and Run

6. 工程优化与管理进阶

6.1 外设库模块化技巧

标准外设库全量编译很耗时，建议在FWlib/src中只添加需要用到的外设文件。例如只用GPIO和USART时，可以只保留：

stm32f10x_gpio.c
stm32f10x_rcc.c
stm32f10x_usart.c

其他外设等需要时再添加，这样可以显著加快编译速度。

6.2 版本兼容性解决方案

当遇到"..\gd32f1x0_lib\cmsis\core_cm3.h"这类路径错误时，通常是工程迁移导致的。解决方法：

删除工程中所有现有文件引用
重新添加本地文件（不要引用绝对路径）
更新Include Paths为相对路径（如../CMSIS）

6.3 工程模板制作

建立稳定可用的工程后，可以制作模板：

删除Output目录下的生成文件
压缩工程目录为zip
下次新建工程时解压修改

我通常会准备多个模板：

基础模板（仅核心文件）
FreeRTOS模板
LWIP网络模板
USB设备模板

7. 常见问题速查手册

7.1 工程配置类问题

现象	可能原因	解决方案
无法打开core_cm3.h	头文件路径错误	检查CMSIS目录是否在Include Paths中
大量未定义错误	未定义USE_STDPERIPH_DRIVER	在C/C++选项卡的Define中添加宏定义
启动文件报错	选错启动文件型号	确认是hd/md/ld后缀，匹配芯片容量

7.2 编译下载类问题

现象	可能原因	解决方案
程序卡在启动代码	时钟配置错误	检查system_stm32f10x.c中的时钟设置
printf无输出	未重定向或微库冲突	参考第4.2节实现输出重定向
下载后不运行	复位电路异常	检查BOOT0引脚电平，确认复位按键正常

7.3 外设使用类问题

现象	可能原因	解决方案
GPIO控制无效	未开启时钟	调用RCC_APB2PeriphClockCmd使能对应外设时钟
USART乱码	波特率不匹配	检查双方波特率设置，确认时钟频率正确
中断不触发	未配置NVIC	除了外设中断使能，还需配置NVIC优先级

最后分享一个调试小技巧：当程序行为异常时，可以临时在启动文件的Reset_Handler开头添加这几行汇编，强制所有引脚输出低电平，方便排查硬件问题：

Reset_Handler: ldr r0, =0x4001100C @ GPIOB_CRH地址 ldr r1, =0x33333333 @ 全部推挽输出 str r1, [r0] ldr r0, =0x40011010 @ GPIOB_ODR地址 mov r1, #0x00 @ 全部输出低 str r1, [r0] @ 继续原有初始化流程...

建站实战干货