1. 为什么需要一个规范的开发环境？
如果你刚开始玩STM32，可能觉得随便建个文件夹，把代码往里一扔，能编译能下载就行。我以前也是这么干的，直到接手了一个学长的项目。打开他的工程，我整个人都懵了——十几个文件夹，名字都看不懂，根本不知道从哪下手改代码。那次经历让我明白，一个清晰、规范的工程结构，不仅仅是“看着舒服”，它直接决定了你后期开发、调试、维护的效率，甚至决定了你和队友会不会因为代码管理而“友尽”。
对于STM32F103这类经典芯片，使用标准库（Standard Peripheral Library）依然是很多初学者和成熟项目的选择。它比HAL库更接近寄存器，能帮你更好地理解硬件原理，代码效率也相对更高。而Keil MDK（我们常说的Keil5）作为ARM芯片开发的“老伙计”，其稳定性和强大的调试功能，让它成为搭建这个学习环境的不二之选。
这篇文章，我就以自己踩过无数坑的经验，带你从零开始，手把手搭建一个基于Keil5和STM32F103标准库的、规范、清晰、可复用的工程模板。这个模板就像你家的工具箱，所有螺丝刀、扳手分门别类放好，下次做项目直接拿出来用，省时省力，心情舒畅。我们不光要“点亮LED”，更要从一开始就养成好习惯。
2. 战前准备：搞定所有必备“弹药”
开工之前，得把家伙事儿备齐。别小看这一步，很多新手卡住就是因为少了下某个文件。我们需要三样核心“弹药”：Keil5软件本身、STM32F1系列的标准库文件包、以及芯片支持包。
首先，是Keil MDK的安装。这个去ARM官网就能找到评估版，安装过程就是一路“Next”，注意安装路径不要有中文和空格，这是所有编程软件的铁律。我习惯装在D:\Keil_v5这样的目录下。安装完成后，它还是个“光杆司令”，不认识我们的STM32F103。
所以第二步，我们要给它“认亲”。打开Keil5，找到那个像小扳手一样的图标“Pack Installer”。在这里，我们需要安装STM32F1系列的Device Family Pack（DFP）。在搜索框输入“STM32F1”，找到官方发布的那个包，点击安装。这个过程其实就是下载并安装芯片的具体型号定义、启动文件等，这样Keil才知道STM32F103VET6、C8T6这些芯片长啥样，该用什么编译器配置。
第三步，也是最关键的一步，获取STM32标准外设库。虽然ST现在主推HAL/LL库，但标准库的经典地位无可替代。你可以通过我提供的网盘链接获取（链接见文末附录），但更推荐去ST官网走一遍流程，毕竟原汁原味。打开ST官网，在“工具与软件” -> “嵌入式软件”里找到“STM32标准外设软件库”，选择F1系列，填写邮箱获取下载链接。解压后，你会得到一个类似STM32F10x_StdPeriph_Lib_V3.5.0的文件夹，这里面就是我们的宝藏。
这个库包里东西很多，但我们主要关注三个子文件夹：Libraries\CMSIS（内核相关）、Libraries\STM32F10x_StdPeriph_Driver（外设驱动，即FWLIB）、以及Project\STM32F10x_StdPeriph_Template（官方工程模板和启动文件）。把它们先准备好，我们接下来的文件夹结构就源于此。
注意：官网下载可能需要注册账号并等待邮件确认，稍微有点繁琐。如果只是用于学习，使用可靠的第三方备份链接快速获取也是常见做法，确保文件完整即可。
3. 构建你的工程“大厦”：文件夹结构详解
现在我们来规划工程的“户型图”。一个混乱的工程就像乱糟糟的房间，找个东西得翻半天。我采用的是一种经过多个项目验证的经典结构，它逻辑清晰，扩展性强。
首先，在硬盘上创建一个项目总文件夹，比如STM32F103_Template。在这个根目录下，我们将创建以下几个子文件夹：
CMSIS： 存放与ARM Cortex-M3内核相关的核心文件。这就像是STM32的“大脑和脊髓”的定义文件。你需要从标准库包的
Libraries\CMSIS\CM3\CoreSupport和Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x这两个位置，拷贝几个关键文件过来。主要是core_cm3.c/.h（内核访问层）、system_stm32f10x.c/.h（系统初始化，包含重要的SystemInit函数）、stm32f10x.h（整个芯片的寄存器映射总头文件，至关重要）以及stm32f10x_conf.h（库配置文件，用来开启或关闭你用到的外设驱动）。FWLIB： 存放STM32标准外设库的驱动源码。把标准库包中
Libraries\STM32F10x_StdPeriph_Driver下的src（.c文件）和inc（.h文件）两个文件夹，整个拷贝到我们工程的FWLIB文件夹里。这里面就是操作GPIO、USART、TIMER等所有外设的底层函数。项目初期，你可以全部添加进工程，但为了编译速度，后期可以通过修改stm32f10x_conf.h来只包含你实际用到的驱动。User： 这是你大展拳脚的地方，所有自己写的代码都放在这里。我建议在里面再建子文件夹，比如
App用于放应用程序模块（如led.c，key.c），Bsp（板级支持包）用于放与具体硬件板子相关的驱动（如oled_spi.c），Doc放一些说明文档。当然，最核心的main.c和main.h直接放在User根目录下。Startup： 存放启动文件。这个文件是用汇编写的，是芯片上电后运行的第一段代码，负责初始化堆栈、设置中断向量表、跳转到main函数。它必须和你的芯片容量严格匹配。从标准库包的
Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm目录下，找到对应的文件。对于常见的STM32F103C8T6（64K Flash），选择startup_stm32f10x_md.s；对于VET6（512K Flash），选择startup_stm32f10x_hd.s。把这个.s文件拷贝过来即可。Project： 这个文件夹专门留给Keil5自己生成的各种文件。包括工程文件（
.uvprojx）、编译输出的中间文件（.o、.axf）和最终的可执行文件（.hex、.bin）。把它们独立出来，能让我们的源码目录非常干净，也方便用Git等工具进行版本管理（可以设置忽略Project文件夹内的生成文件）。Readme.txt： 在根目录下建一个简单的文本文档，用一两句话说明这个工程是干什么的，用了什么芯片，编译注意事项等。好记性不如烂笔头，过几个月你自己回头看，它会救你的命。
这样的结构，就像一个五脏俱全的小公司：CMSIS是公司章程（内核规范），FWLIB是各个职能部门（外设驱动），User是业务项目部（你的应用代码），Startup是公司开业典礼（启动流程），Project是行政档案室（工程管理），Readme是公司简介。各司其职，井井有条。
4. 在Keil5中“施工”：创建与配置工程
文件夹建好了，现在打开Keil5，开始真正的“施工”。
第一步，创建新工程。点击Project -> New uVision Project...，定位到我们刚才创建的Project文件夹内，给工程起个名字，比如template。点击保存后，会弹出设备选择窗口。在这里找到STMicroelectronics->STM32F103 Series，并根据你的具体芯片型号选择，比如STM32F103VE（对于VET6）。点击OK后，会询问你是否添加启动文件，这里一定要点“否”！因为我们打算使用自己从标准库中挑选的、更纯净的启动文件，Keil自带的可能版本不匹配或包含额外内容。
第二步，管理工程的文件组。在Keil左侧的Project窗口，你会看到一个Target 1。我们把它改名为Template（右键Rename）。然后，我们创建与文件夹对应的文件组。右键Template->Manage Project Items...。在Project Items标签页下，点击中间的“新建”图标（一个文件夹带星星），创建组：CMSIS，FWLIB，User，Startup。你可以通过左侧的“向上”、“向下”箭头调整顺序，我个人喜欢按Startup->CMSIS->FWLIB->User这样的依赖顺序排列。
第三步，向各组添加文件。
- 点击
Startup组，然后点击右侧的Add Files，导航到我们自建的Startup文件夹，选择你拷贝过来的那个.s启动文件（注意文件类型选All Files (*.*)才能看到）。 - 点击
CMSIS组，添加CMSIS文件夹下的system_stm32f10x.c和core_cm3.c（如果有的话，通常只需要.h，但.c也可能需要）。 - 点击
FWLIB组，这里文件较多，可以一次性多选。进入我们自建的FWLIB/src文件夹，按Ctrl+A全选所有.c文件添加。初期为了省事可以全加，后期再精简。 - 点击
User组，添加User文件夹下的main.c（可以先创建一个空的）。你也可以把User/App，User/Bsp等子文件夹里的.c文件也添加进来，或者为它们单独建子组。
第四步，配置关键的工程选项。点击魔术棒图标Options for Target...，这里是核心配置区。
- 在
Target标签页，确认芯片型号正确。最重要的是，根据你的芯片，在Code Generation里勾选Use MicroLIB。这是一个针对嵌入式系统优化的精简C库，可以显著减少程序体积。 - 在
Output标签页，点击Select Folder for Objects...，把输出目录指定到Project\Objects文件夹。同时勾选Create HEX File，这样编译后才会生成可烧录的hex文件。 - 在
C/C++标签页，这是重中之重。在Define输入框里，添加两个宏定义：STM32F10X_HD（根据你的芯片容量，可能是LD，MD，HD，XL）和USE_STDPERIPH_DRIVER。第一个宏告诉编译器我们用的是大容量芯片，第二个宏告诉标准库我们要使用标准外设驱动。然后，在Include Paths这里，添加我们所有包含头文件的路径：../CMSIS，../FWLIB/inc，../User。一定要点后面的...按钮浏览添加，不要手动输入。 - 在
Debug标签页，选择你使用的调试器，比如ST-Link Debugger，然后点击旁边的Settings，确认SWD接口和芯片ID识别正确。 - 在
Utilities标签页，同样选择你的调试器，并勾选Update Target before Debugging，这样每次调试前会自动下载程序。
配置完成后，点击OK保存。至此，工程的骨架就搭建完毕了。你可以尝试编译一下（F7），虽然main.c是空的，但应该能通过编译，只有0个错误和几个警告（通常是说未使用某些函数）。这证明你的环境通路已经打通了。
5. 编写第一个“Hello World”：点亮LED
环境搭好了，不点个灯庆祝一下吗？我们来写一个最简单的LED闪烁程序，验证整个工程是否工作正常。
首先，在User文件夹下创建main.c和main.h。在main.h里，我们包含最基础的头文件，并做一些防止头文件重复包含的预处理。
#ifndef __MAIN_H #define __MAIN_H #include "stm32f10x.h" // 这是总头文件，必须包含 #include <stdio.h> // 如果后续需要printf // 可以在这里定义一些全局使用的宏，比如LED引脚 #define LED_GPIO_PORT GPIOB #define LED_GPIO_PIN GPIO_Pin_0 #endif /* __MAIN_H */然后，在main.c里，我们实现一个简单的延时函数（先用循环凑合，实际项目建议用定时器）和主函数。
#include "main.h" // 简单的软件延时函数，不精确，仅供测试 void Delay(uint32_t count) { for(; count != 0; count--); } int main(void) { // 1. 初始化系统时钟，标准库的SystemInit()通常将时钟设置为72MHz（外部晶振8MHz时） // 这个函数在启动文件中被调用，我们也可以在这里再调用一次确保 SystemInit(); // 2. 开启GPIOB的时钟。STM32任何外设使用前必须先开启其时钟，这是与51单片机最大的不同之一。 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // 3. 配置GPIO引脚为推挽输出模式 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = LED_GPIO_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 输出速度50MHz GPIO_Init(LED_GPIO_PORT, &GPIO_InitStructure); // 4. 主循环，实现LED闪烁 while(1) { GPIO_SetBits(LED_GPIO_PORT, LED_GPIO_PIN); // 输出高电平，假设LED共地，则灯灭 Delay(5000000); // 延时 GPIO_ResetBits(LED_GPIO_PORT, LED_GPIO_PIN); // 输出低电平，灯亮 Delay(5000000); } }写好代码后，记得在Keil的User组里添加这个main.c文件（如果创建时没添加）。然后编译、下载到你的开发板。如果一切顺利，你应该能看到连接到PB0引脚的LED开始规律地闪烁。这个简单的成功，意味着你的开发环境、工程配置、代码编写、编译下载整个链路全部跑通了，这是一个非常重要的里程碑。
6. 进阶优化与避坑指南
基础工程跑起来后，我们还可以做一些优化，让它更专业、更好用。同时，我也分享几个我早期常踩的“坑”。
优化一：合理管理FWLIB文件。全添加所有外设驱动文件会导致编译慢，工程大。我们可以编辑CMSIS文件夹下的stm32f10x_conf.h文件。这个文件里有一堆#define语句，用来启用或禁用某个外设的驱动。比如，你只用到了GPIO和USART1，那就只保留#define USE_STDPERIPH_DRIVER，#define GPIO和#define USART1的注释打开（去掉//），其他的都注释掉。然后回到Keil工程，在FWLIB组里，只保留stm32f10x_gpio.c，stm32f10x_usart.c以及它们依赖的misc.c，stm32f10x_rcc.c等核心文件，把其他的.c文件都移除。这样编译速度会快很多。
优化二：创建调试输出（printf）重定向。调试时不能总是点灯，串口打印信息才是王道。在User文件夹下创建一个retarget.c文件。在里面重写fputc函数，将输出指向你的串口。然后在main.c里初始化对应的串口外设。这样，你就可以在代码里随意使用printf(“System Start…\r\n”)了，信息会通过串口助手显示在电脑上，调试效率倍增。
避坑指南：
- 宏定义错误：编译时如果报错
stm32f10x.h里找不到某个寄存器的定义，99%是因为C/C++标签页里的STM32F10X_HD这类宏没定义，或者定义错了（比如用了C8T6却定义了HD）。 - 头文件路径缺失：编译报错
cannot open source file “stm32f10x_gpio.h”， 肯定是Include Paths里没有添加../FWLIB/inc路径。 - 启动文件选错：程序下载后完全不运行，或者一运行就进HardFault。首先检查启动文件
.s是否与芯片Flash容量匹配。用错了容量型号的启动文件，会导致栈堆空间设置错误，程序跑飞。 - 忘记开启外设时钟：这是新手百分百会犯的错。代码配置GPIO、USART看起来都没问题，但就是没反应。请记住：STM32的每个外设（除了内核）都有一个时钟开关，默认是关闭的，用之前必须用
RCC_APBxPeriphClockCmd()函数打开。GPIO在APB2上，USART1在APB2上，USART2/3在APB1上。 - 工程路径移动后报错：如果你把整个工程文件夹挪了个位置，再次打开Keil工程可能会提示找不到文件。这时需要在
Manage Project Items里重新为每个组添加一次文件（Keil保存的是相对路径，一般移动后仍有效，但跨盘符或结构变化大会出问题）。
搭建环境的过程，本身就是一次深刻的学习。当你按照这个指南，一步步完成，并最终看到LED闪烁的那一刻，你收获的不仅仅是一个可用的开发环境，更是对STM32项目架构、编译流程、工具链配合的直观理解。这个模板将成为你未来所有STM32F103项目坚固的起点，你可以把它备份在云盘，随时取用。接下来，你就可以在这个规范的基础上，尽情添加你的传感器驱动、通信协议、业务逻辑，去创造更有趣的东西了。
