1. 环境准备与工具安装

开始STM32开发之前，我们需要准备好必要的软件和硬件工具。对于初学者来说，选择一套简单易用的工具链至关重要。我推荐使用Keil MDK-ARM作为开发环境，配合ST-Link调试器，这是目前最稳定且资料最丰富的组合。

硬件方面，你需要准备一块STM32F103C8T6最小系统板，这款芯片因为性价比高且资源丰富，被称为"单片机界的Hello World"。还需要一个ST-Link调试器，建议选择V2版本，兼容性更好。另外准备4根母对母杜邦线用于连接调试器和开发板。

软件安装首先从Keil官网下载MDK-ARM安装包，安装过程中记得勾选"Pack Installer"选项，这样后面安装芯片支持包会更方便。安装完成后，打开Pack Installer，搜索STM32F1系列芯片包并安装。这一步很关键，如果没有安装芯片包，创建工程时就无法选择STM32F103C8T6这个型号。

ST-Link驱动安装有两种方式：一是从ST官网下载STSW-LINK009安装包，二是使用第三方打包好的驱动。我建议新手直接去ST官网下载，虽然需要注册账号，但保证是最新版本。安装驱动时记得右键选择"以管理员身份运行"，否则可能安装失败。

安装完成后，把ST-Link通过USB线连接到电脑，打开设备管理器，如果在"通用串行总线设备"中看到"STM32 STLink"设备，就说明驱动安装成功了。有时候可能需要重新插拔一次才能识别，这是正常现象。

2. 工程创建与配置

打开Keil软件，点击Project菜单选择New μVision Project。这里有个小技巧：先在电脑上创建一个专门的工作目录，比如"STM32_Projects"，然后在里面为每个新工程创建单独的文件夹。我习惯用"日期+功能"的方式命名，比如"202405_LED_Blink"，这样后期查找和管理都很方便。

选择芯片型号时，在搜索框输入"STM32F103C8T6"，Keil会自动筛选出匹配的型号。注意要选择带有"MD"后缀的型号，这表示中容量芯片（128KB Flash）。选错容量会导致后续的启动文件不匹配，编译时会出现各种奇怪错误。

工程创建完成后，Keil会弹出运行时环境配置对话框，这里直接点取消。我们使用标准外设库而不是HAL库，虽然配置稍麻烦，但更能理解底层原理。

接下来在工程目录下创建三个文件夹：Start、Library和User。Start文件夹存放启动文件和系统配置文件，Library存放标准外设库文件，User存放用户代码。这种组织结构清晰明了，后期维护很方便。

从STM32标准外设库中复制必要的文件到这些文件夹：startup_stm32f10x_md.s启动文件（注意要选择md中容量版本）、system_stm32f10x.c系统初始化文件、stm32f10x.h头文件，以及整个标准外设库的inc和src文件夹。我建议把main.c也提前复制到User文件夹，这样就不用在Keil里重新创建了。

回到Keil，点击工具栏上的工程管理按钮（三个小方块图标），删除默认的Source Group，新建三个组分别命名为Start、Library和User。然后为每个组添加对应的文件：Start组添加启动文件和系统文件，Library组添加外设库的所有.c文件，User组添加main.c和其他用户文件。

3. 编译设置与头文件配置

点击魔术棒图标打开工程选项，这里需要配置几个关键设置。在Target标签页中，修改晶振频率为8.0MHz，这是STM32F103C8T6外部晶振的典型值。虽然芯片内部有RC振荡器，但为了精度还是建议使用外部晶振。

在Output标签页中，一定要勾选"Create HEX File"，这样编译后会生成可烧录的hex文件。Hex文件是Intel格式的二进制文件，包含了程序代码和地址信息，烧录工具通过这个文件将程序写入芯片Flash。

C/C++标签页的配置最为重要。在Define输入框中添加两个宏定义：USE_STDPERIPH_DRIVER和STM32F10X_MD。第一个宏告诉编译器我们要使用标准外设库，第二个宏指定芯片容量为中容量。如果这里写错了，比如写成HD（大容量），编译虽然能通过，但运行时会出现各种异常。

在Include Paths中添加三个头文件路径：Start、Library/inc和User文件夹的路径。这样编译器就知道去哪里查找头文件了。我建议使用相对路径而不是绝对路径，这样工程移动到其他电脑时不会出现路径错误。

Debug标签页中选择ST-Link Debugger，然后点击Settings进行详细配置。在Debug选项卡中选择SW接口模式，这是目前最常用的调试接口，只需要两根线（SWDIO和SWCLK）就能实现调试和烧录功能。

在Flash Download选项卡中勾选"Reset and Run"，这样程序烧录完成后会自动复位运行，不需要手动按复位键。还要确认Flash算法选择正确，对于STM32F103C8T6应该选择128KB容量的算法。如果这里选错，烧录时可能会擦除不该擦除的区域。

4. ST-Link连接与硬件调试

硬件连接方面，ST-Link与STM32F103C8T6需要连接四根线：3.3V电源线、GND地线、SWDIO数据线和SWCLK时钟线。连接时一定要注意电源极性，反接可能会烧毁芯片。我建议先接GND，再接3.3V，最后接信号线。

接线顺序很重要：ST-Link的3.3V接开发板的3.3V，GND接GND，SWDIO接SWDIO（PA13），SWCLK接SWCLK（PA14）。有些开发板上这些接口可能标有其他名称，比如JTAG接口，但实际使用SWD模式只需要这四个引脚。

连接好后给开发板上电，在Keil中点击Settings，如果能在SW Device中看到设备ID，就说明连接成功。如果看不到设备，首先检查接线是否正确，然后检查ST-Link驱动是否安装成功。有时候需要点击"Device Connect"按钮手动连接。

调试器固件升级也很重要。当第一次使用ST-Link时，Keil可能会提示固件需要升级。建议选择升级到最新版本，新版本通常修复了一些已知问题并提高了稳定性。升级过程中不能断开USB连接，否则可能导致ST-Link变砖。

在调试界面可以设置断点、查看变量、单步执行等。我特别喜欢实时查看外设寄存器的功能，可以直观地看到寄存器值的变化，对于理解外设工作原理很有帮助。比如在调试GPIO时，可以直接查看ODR寄存器值来确认输出状态。

5. 常见问题与解决方案

第一个常见问题是驱动安装失败。有时候Windows系统会自动安装错误的驱动，这时需要手动指定驱动路径。在设备管理器中右键点击ST-Link设备，选择更新驱动，然后手动选择从ST官网下载的驱动文件夹。

第二个问题是Keil无法识别ST-Link。这可能是因为USB线质量不好导致通信不稳定，建议使用带屏蔽的USB线。也可能是USB端口供电不足，尝试换一个USB口或者使用带电源的USB Hub。

编译时经常出现的错误是头文件找不到。这通常是因为Include Paths设置不正确，或者路径中包含中文或特殊字符。我建议所有路径都使用英文命名，并且不要放在太深的目录层级中。

链接错误往往是因为启动文件选择错误。STM32F103C8T6是中容量芯片，应该使用startup_stm32f10x_md.s文件。如果误用了hd（大容量）或ld（小容量）版本，链接时会出现内存区域定义错误。

烧录失败可能是由于芯片写保护。如果之前烧录过带有写保护的程序，需要先解除保护。在Keil的Utilities设置中，勾选"Reset and Run"通常可以解决这个问题。如果还不行，可能需要使用STM32 ST-Link Utility工具手动解除保护。

调试时程序跑飞是另一个常见问题。这可能是堆栈大小设置不足导致的。在Target选项中，默认的堆栈大小可能不够用，特别是使用大量局部变量或者递归调用时。我一般设置Stack Size为0x1000，Heap Size为0x800，这样基本上能满足大部分应用需求。

6. 实战案例：LED闪烁程序

现在我们用一个简单的LED闪烁程序来验证整个开发环境。首先在main.c文件中包含必要的头文件：#include "stm32f10x.h"和#include "stm32f10x_gpio.h"。这两个头文件提供了芯片和外设的寄存器定义。

定义LED连接的GPIO端口，假设LED连接在PC13引脚（这是很多最小系统板的配置）。首先需要开启GPIOC的时钟，因为STM32的外设时钟默认是关闭的，以节省功耗。使用RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE)函数来开启时钟。

配置GPIO为推挽输出模式，速度设置为50MHz。STM32的GPIO可以配置为多种模式和速度，输出模式选择推挽输出，这样可以提供较强的驱动能力。速度选择50MHz虽然耗电稍大，但响应更快。

在主函数中初始化GPIO后，就可以通过设置ODR寄存器或者使用GPIO_WriteBit函数来控制LED亮灭了。使用简单的延时循环实现闪烁效果，虽然这种延时方式不精确，但对于测试来说足够了。

编译工程时，如果出现0错误0警告，说明代码语法没有问题。点击LOAD按钮烧录程序，如果一切正常，会显示"Erase Done"、"Programming Done"、"Verify OK"等信息，最后提示"Application running..."。

观察开发板上的LED，应该可以看到规律的闪烁。如果LED不亮，首先检查硬件连接，用万用表测量PC13引脚的电平变化。如果电平有变化但LED不亮，可能是LED极性接反了或者限流电阻太大。

这个简单程序虽然功能简单，但验证了整个开发环境的正确性：工程配置、编译烧录、硬件调试都正常工作。在此基础上，可以进一步添加其他外设功能，如串口通信、ADC采样、定时器中断等。

7. 进阶调试技巧

掌握基本调试功能后，可以学习一些高级调试技巧。比如使用实时变量监视功能，可以实时查看变量值的变化而不需要暂停程序运行。这对于调试实时系统特别有用，比如查看ADC采样值或者通信数据。

断点设置也有技巧。除了普通断点，还可以设置条件断点，只有当特定条件满足时才会触发。比如设置当变量值大于100时暂停，这样就不用每次循环都暂停，大大提高了调试效率。

调用堆栈功能可以显示函数调用关系，当程序出现异常时，可以快速定位到问题发生的上下文。配合局部变量窗口，可以查看当前函数内的所有变量值，快速找出异常原因。

性能分析功能可以统计各个函数的执行时间和调用次数，对于优化程序性能很有帮助。我发现很多初学者写的程序效率低下，通过性能分析可以快速找到瓶颈函数。

Flash断点是另一个有用功能。普通断点数量有限（通常4-6个），但Flash断点可以在代码段设置大量断点。不过要注意Flash断点会影响程序执行速度，不适合在实时性要求高的场景使用。

最后推荐使用版本控制工具如Git来管理工程代码。每次重大修改前提交一个版本，如果新代码出现问题可以快速回退。我吃过不少亏，现在养成了频繁提交的好习惯。