1. 为什么选择Keil5开发STM32？
第一次接触STM32开发的朋友，肯定会被各种开发环境搞得眼花缭乱。我刚开始学的时候也纠结过，到底用IAR、Keil还是直接用VSCode+插件？后来发现Keil MDK（也就是常说的Keil5）是最适合新手的。原因很简单：官方支持好、资料多、调试方便。特别是ST官方提供的HAL库和CubeMX工具，跟Keil配合起来简直不要太顺手。
记得我第一次用Keil5点亮LED时，那种成就感至今难忘。不过当时也踩了不少坑，比如芯片包下载慢、工程配置出错、烧录失败等等。这些问题看似简单，但对新手来说可能就是一道难以逾越的坎。下面我就把这些经验教训都整理出来，让你少走弯路。
2. 开发环境搭建
2.1 软件安装避坑指南
Keil MDK的安装过程看似简单，但有几个关键点需要注意。首先建议去官网下载最新版本，目前最新是5.38a。安装时最容易被忽视的就是安装路径问题——千万别装在中文路径下！我见过太多人因为路径有中文导致各种奇怪问题。
安装过程中会让你选择组件，这里建议全选。特别是CMSIS组件，这是ARM的通用接口标准，STM32开发必须用到。安装完成后先别急着打开软件，还有更重要的一步：安装芯片支持包。
2.2 芯片包安装的两种方法
Keil5和旧版本最大的区别就是芯片包需要单独安装。这里有两个方法：
第一种是通过Pack Installer在线安装。点击工具栏上的这个图标，等它加载完芯片列表（这个过程可能会很慢）。然后在左侧找到你的芯片型号，比如STM32G0系列，右侧点击Install。但这个方法有个致命问题：国内访问国外服务器速度很慢，经常下载到一半就断了。
第二种方法是我推荐的：手动下载Pack包。直接去Keil官网的Pack下载页面，搜索STM32G0，下载对应的DFP包（Device Family Pack）。下载完成后双击安装即可。如果官网下载慢，可以去国内论坛找别人分享的包，但要注意版本兼容性。
3. 创建第一个STM32工程
3.1 工程创建步骤详解
打开Keil5，点击Project→New μVision Project，选择一个英文路径，给工程起个名字。这时会弹出设备选择窗口，找到你的芯片型号，比如STM32G071RB。关键点来了：在接下来的对话框里一定要选择CMSIS下的CORE，这是ARM的核心支持包。
创建完工程后，你会发现左侧Project窗口里已经自动生成了几个文件。这些都是Keil自动配置的启动文件和基本框架。但这时候工程还不能直接使用，还需要添加用户代码。
3.2 添加用户代码的注意事项
右键点击Target1，选择Add New Item，可以添加.c或.h文件。这里有个新手常犯的错误：添加文件后忘记包含头文件路径。比如你新建了一个user文件夹放自己的代码，就必须在Options for Target→C/C++→Include Paths里添加这个路径。
我建议的目录结构是这样的：
- Project
- CMSIS (系统自动生成)
- User
- main.c
- gpio.c
- gpio.h
- Drivers
- STM32G0xx_HAL_Driver
这样分类清晰，后期维护也方便。记得每添加一个新文件，都要检查头文件路径是否包含。
4. 关键配置详解
4.1 调试器设置
开发板连接电脑后，进入Options for Target→Debug选项卡。这里要选择你使用的调试器，常见的有ST-Link、J-Link等。如果是ST官方开发板，一般自带ST-Link，直接选择ST-Link Debugger即可。
然后点击Settings，在Port里选择SWD（这是STM32最常用的调试接口）。如果一切正常，你应该能看到设备IDCODE。如果这里显示"No Target Connected"，检查以下几点：
- 开发板是否供电
- SWD线是否连接正确
- 驱动是否安装
4.2 编译选项配置
在Options for Target→Target选项卡里，有几个关键设置：
- Xtal（晶振频率）：根据你的硬件设置，通常是8MHz
- Use MicroLIB：建议勾选，可以减小代码体积
- Optimization：新手建议选-O0，调试更方便
Output选项卡里记得勾选Create HEX File，这样会生成hex格式的烧录文件。Listing选项卡可以生成.map文件，方便查看代码内存分布。
5. 编写第一个LED程序
5.1 GPIO初始化代码
在main.c中添加以下代码：
#include "stm32g0xx_hal.h" void SystemClock_Config(void); static void MX_GPIO_Init(void); int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); while (1) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); HAL_Delay(500); } } void MX_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitStruct.Pin = GPIO_PIN_5; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); }这段代码实现了PA5口每隔500ms翻转一次电平。注意要根据你的开发板原理图确认LED连接的引脚。
5.2 常见编译错误解决
第一次编译可能会遇到以下错误：
- "stm32g0xx_hal.h: No such file"：说明头文件路径没设置对
- "undefined symbol SystemClock_Config"：需要实现这个函数
- "multiple definition of __io_putchar"：取消勾选Use MicroLIB
遇到错误不要慌，仔细看错误信息，大部分问题都能通过正确配置解决。
6. 烧录与调试技巧
6.1 烧录步骤详解
编译成功后，点击Load按钮开始烧录。如果一切正常，会显示"Programming Done"和"Verify OK"。但新手常会遇到这些问题：
- 烧录失败：检查调试器连接，重新插拔试试
- 程序不运行：在Debug→Settings里勾选Reset and Run
- 无法识别芯片：检查芯片供电，有时需要按住复位键再点击烧录
6.2 基础调试方法
点击Debug按钮进入调试模式，几个常用功能：
- 单步执行（F11）：逐行执行代码
- 跳过函数（F10）：不进入函数内部
- 断点（F9）：在代码行左侧点击设置断点
- 查看变量：在Watch窗口添加变量名
- 查看外设寄存器：在Peripherals菜单里选择要查看的外设
调试时如果发现程序跑飞了，可以查看Call Stack窗口，看看函数调用顺序是否正确。
7. 常见问题解决方案
7.1 芯片包下载失败
这是最让人头疼的问题。除了前面说的手动下载方法，还可以：
- 使用国内镜像源
- 修改hosts文件加速访问
- 在非高峰时段下载
如果实在下载不了，可以去ST官网下载HAL库，里面通常包含对应芯片的启动文件，可以临时替代。
7.2 工程无法编译
除了前面提到的路径问题，还要注意：
- 启动文件是否匹配你的芯片型号
- 是否选择了正确的编译器版本（AC5或AC6）
- 是否缺少必要的宏定义（比如STM32G071xx）
有时候清理工程（Project→Clean）再重新编译也能解决奇怪的问题。
8. 进阶建议
当你成功点亮第一个LED后，可以尝试以下进阶操作：
- 使用STM32CubeMX生成初始化代码
- 添加FreeRTOS实时操作系统
- 移植LVGL图形界面库
- 使用SWV实现printf重定向
记住一点：Keil只是工具，重点是要理解STM32的工作原理。我建议新手在熟悉基本操作后，多看看生成的汇编代码，了解编译器是如何把你的C代码转换成机器指令的。
