Keil 5 搭建 STM32 开发环境：从零构建库函数工程实战
1. 环境准备与资源获取
第一次接触STM32开发的朋友可能会被各种专业术语吓到，但其实搭建开发环境就像组装一台电脑，只要按步骤把各个部件准备好就行。我这里以最常用的STM32F103C8T6核心板为例，手把手带你完成整个流程。
首先需要准备三个关键工具：Keil MDK 5开发环境、STM32标准外设库、以及对应的芯片支持包。Keil MDK 5是ARM官方推荐的开发工具，你可以直接在Keil官网下载评估版，虽然代码大小有限制，但对于学习完全够用。标准外设库现在改名叫STM32CubeF1，包含了所有外设驱动的源代码和例程。芯片支持包则是连接开发环境和具体芯片的桥梁，包含了芯片的启动文件、链接脚本等关键资源。
我建议先在电脑上创建一个专门的工作目录，比如"D:\STM32_Projects"，这样后续管理起来会比较方便。下载好的标准外设库解压后，你会看到Libraries文件夹里放着CMSIS和STM32F10x_StdPeriph_Driver这两个关键目录，前者是ARM内核相关的文件，后者就是我们要用的外设驱动库。
2. 创建基础工程框架
打开Keil MDK 5，点击Project→New μVision Project，在弹出的对话框中选择刚才创建的工作目录。这里有个小技巧：我习惯在项目名称后面加上日期，比如"Template_202308"，这样以后查找起来更方便。
选择芯片型号时要特别注意，虽然我们用的是STM32F103C8T6，但在Keil的器件列表中选择STM32F103C8就行，它们属于同一个系列。确认后会弹出运行时环境管理对话框，这里我们选择"Cancel"，因为我们要手动添加库文件，这样能更好地理解工程结构。
接下来在工程目录下创建几个关键文件夹：
- Start：存放启动文件和内核相关文件
- User：存放用户代码如main.c
- Library：存放标准外设库文件
- Output：存放编译生成的hex等输出文件
右键Target 1选择"Manage Project Items"，在这里可以添加和重命名组。我建议按照文件夹结构来命名组，比如Start组对应Start文件夹，这样结构清晰，后期维护方便。
3. 添加启动文件与内核支持
启动文件是STM32上电后第一个执行的代码，相当于PC的BIOS。在CMSIS\Device\ST\STM32F10x\Source\Templates\arm目录下，找到startup_stm32f10x_md.s文件（md表示中等容量），这就是我们需要的启动文件。把它复制到Start文件夹，然后在Keil中添加到Start组。
接下来添加三个关键的内核文件：
- system_stm32f10x.c和.h：系统时钟配置
- stm32f10x.h：外设寄存器定义
- core_cm3.c和.h：Cortex-M3内核支持
这些文件都可以在CMSIS目录下找到。添加完毕后，记得设置头文件路径：点击魔术棒图标→C/C++→Include Paths，添加Start文件夹的路径。这一步很关键，否则编译器会提示找不到头文件。
4. 配置标准外设库
现在我们来添加STM32的标准外设库。将STM32F10x_StdPeriph_Driver目录下的inc和src文件夹复制到Library文件夹。回到Keil中，新建一个Library组，把src文件夹下的所有.c文件添加进来。
这里有个实用技巧：可以按住Ctrl键多选文件，一次性添加，比一个个添加快多了。添加完成后，同样需要设置头文件路径，把Library/inc目录添加进去。
在User文件夹中创建main.c文件，先写个最简单的测试程序：
#include "stm32f10x.h" int main(void) { while(1) { // 你的代码写在这里 } }注意最后要留一个空行，否则Keil会给出警告。这是Keil的一个小特性，很多新手都会在这里踩坑。
5. 关键配置与编译选项
现在工程基本框架已经搭建完成，但还需要几个关键配置才能正常编译。首先在工程选项的C/C++选项卡中，找到Define输入框，添加"USE_STDPERIPH_DRIVER,STM32F10X_MD"这两个宏定义。前者告诉编译器我们要使用标准外设库，后者指定芯片容量类型。
在Output选项卡中，把输出目录设置为之前创建的Output文件夹，并勾选"Create HEX File"，这样编译后会生成可以直接下载的hex文件。在Listing选项卡中，也把输出目录设为Output，方便查找生成的列表文件。
点击编译按钮，如果一切配置正确，应该能看到"0 Error(s), 0 Warning(s)"的提示。如果出现错误，最常见的原因是头文件路径没有设置正确，或者宏定义写错了。我建议新手遇到问题时，先检查这两项配置。
6. 工程优化与调试配置
基础工程虽然能编译通过，但还有优化空间。在C/C++选项卡中，把优化等级设为-O0（不优化），这样调试时变量值会更准确。等代码稳定后，可以改为-O1或-O2提高运行效率。
在Debug选项卡中，选择你使用的调试工具，比如ST-Link或J-Link。勾选"Run to main()"，这样复位后会直接停在main函数开始处，省去了每次手动跳转的麻烦。
为了便于版本管理，我建议在工程目录下再创建一个Doc文件夹，存放项目文档和说明。同时，可以在User文件夹中添加一个readme.txt，记录工程创建日期、配置说明等信息。这些小细节在实际项目开发中非常有用。
7. 常见问题排查
在实际操作中，可能会遇到各种问题。比如编译时报错"undefined symbol SystemInit"，这是因为启动文件会调用SystemInit函数来初始化时钟，但我们没有提供实现。解决方法是在system_stm32f10x.c中取消SystemInit函数定义的注释。
另一个常见问题是下载程序后芯片没反应。这时可以检查：
- 启动模式是否正确（BOOT0和BOOT1引脚状态）
- 时钟配置是否正确
- 复位电路是否正常
有时候程序能下载但不能运行，可以在main函数开头加个简单的GPIO操作，比如点亮LED，这样可以快速验证程序是否真的在运行。