简介：STM32F10x标准库3.6.0最终版是ST官方为STM32F10X系列推出的标准外设库，面向使用STM32芯片进行嵌入式开发的工程师、学生及爱好者。它把底层寄存器操作封装成库函数，开发者无需逐位配置寄存器，直接调用即可完成GPIO、定时器、串口等外设功能，能显著降低开发门槛、提升代码可读性与移植效率。压缩包共960个文件，约21.25MB，以349个c源文件与277个h头文件为主体，另含txt说明、s汇编、lsl链接脚本、ld与icf分散加载文件、uvproj与ewp等工程文件，覆盖源码、启动文件、工程模板与操作说明书，目录结构完整。目前已有2820人学习下载。对于刚接触STM32标准库或需要稳定最终版做项目移植的开发者，这份资源可直接作为工程模板与函数参考，帮助快速搭建开发环境、理解外设驱动组织方式，减少重复造轮子的时间。
1. 从一堆报错说起：为什么我还在用 STM32F10x 标准库 3.6.0
上周帮一个做电机控制的朋友排查问题，他用的是一块 STM32F103C8T6 最小系统板，Keil 里编译一切正常，烧录后串口就是不出数据。折腾了一下午，最后发现是启动文件选错了——他用了startup_stm32f10x_hd.s，而芯片是中容量，应该用startup_stm32f10x_md.s。这种坑在标准库环境里太常见了，版本对不上、启动文件选错、宏定义没加，任何一个环节出问题都能让你卡半天。
STM32F10x 标准库 3.6.0 是 ST 官方在 2011 年左右发布的最终版本，之后官方主推 HAL 库和 LL 库，标准库就停更了。但十年过去，大量存量项目、教学实验、竞赛作品依然跑在这个版本上。原因很直接：寄存器操作透明、代码量小、资料铺天盖地，对于 F103 这种经典芯片来说，标准库的掌控感是 HAL 给不了的。如果你正在接手一个老项目，或者想从寄存器层面理解 STM32 的外设驱动，这套库依然是绕不开的起点。
这篇笔记记录的是我完整搭建一套 STM32F10x 标准库 3.6.0 开发环境的过程，从文件获取、目录组织、Keil 工程配置到编译验证，每一步都落到具体操作。适合刚接触 STM32 的新手照着走一遍，也适合很久没碰标准库的老手快速回忆版本差异和配置细节。
2. 环境准备：库文件、工具链和目录结构
2.1 获取标准库 3.6.0 的完整文件
标准库 3.6.0 的发布包通常包含以下几个核心目录：Libraries（CMSIS 内核支持 + 外设驱动）、Project（官方例程模板）、Utilities（评估板相关代码）、Release_Notes（版本说明）。我一般会从 ST 官方渠道或长期维护的镜像获取，拿到的是一个压缩包，解压后大约 30MB 左右。
解压后先别急着往 Keil 里塞，花两分钟确认目录结构：
STM32F10x_StdPeriph_Lib_V3.6.0/ ├── Libraries/ │ ├── CMSIS/ │ │ ├── CM3/ │ │ │ ├── CoreSupport/ # core_cm3.c/h │ │ │ └── DeviceSupport/ # system_stm32f10x.c/h, stm32f10x.h │ │ └── ... │ └── STM32F10x_StdPeriph_Driver/ │ ├── inc/ # 所有外设头文件 │ └── src/ # 所有外设源文件 ├── Project/ │ └── STM32F10x_StdPeriph_Template/ │ ├── main.c │ ├── stm32f10x_conf.h │ ├── stm32f10x_it.c/h │ └── system_stm32f10x.c └── Utilities/这里有个容易忽略的点：CMSIS/CM3/CoreSupport下的core_cm3.c和core_cm3.h是 Cortex-M3 内核的通用文件，而DeviceSupport下的system_stm32f10x.c和stm32f10x.h是 ST 针对 F10x 系列定制的。两者缺一不可，很多人只复制了外设驱动，忘了内核文件，编译时就会报core_cm3.h: No such file or directory。
2.2 建立自己的工程目录骨架
官方模板能用，但直接拿来改容易乱。我习惯在项目根目录下建一个清晰的骨架，后续加外设、换芯片型号都方便：
MyProject/ ├── CMSIS/ # 从官方库复制 │ ├── core_cm3.c/h │ ├── system_stm32f10x.c/h │ └── stm32f10x.h ├── FWlib/ # 从官方库复制 │ ├── inc/ │ └── src/ ├── User/ # 自己写的代码 │ ├── main.c │ ├── stm32f10x_conf.h │ ├── stm32f10x_it.c/h │ └── stm32f10x_it.h ├── Startup/ # 启动文件 │ └── startup_stm32f10x_md.s └── Output/ # 编译输出（Keil 自动生成）复制文件时注意：stm32f10x_conf.h是从官方模板的Project/STM32F10x_StdPeriph_Template/下拿的，它决定了你启用哪些外设驱动。默认情况下所有外设都是注释掉的，用到哪个就取消注释哪个，这样能减少编译时间和代码体积。
2.3 启动文件的选择逻辑
启动文件在Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/startup/arm/下，有多个版本：
| 启动文件 | 适用芯片 | Flash 容量 |
|---|---|---|
| startup_stm32f10x_ld.s | 小容量 | 16-32KB |
| startup_stm32f10x_md.s | 中容量 | 64-128KB |
| startup_stm32f10x_hd.s | 大容量 | 256-512KB |
| startup_stm32f10x_xl.s | 超大容量 | 512KB-1MB |
| startup_stm32f10x_cl.s | 互联型 | 带以太网/USB OTG |
选错启动文件最典型的症状是：编译能过，烧录后程序不跑，或者中断进不去。因为启动文件里定义了中断向量表，容量不对应时向量表偏移和栈顶地址都会错。我一般会先查芯片型号对应的 Flash 容量，再决定用哪个。比如 STM32F103C8T6 是 64KB Flash，属于中容量，选startup_stm32f10x_md.s。
提示：如果你用的是 Keil MDK，启动文件需要添加到工程的目标组里，并且要在 Options for Target → C/C++ → Define 中加上对应的宏，比如
STM32F10X_MD, USE_STDPERIPH_DRIVER。
3. Keil 工程配置：从新建到编译通过
3.1 新建工程并添加文件分组
打开 Keil MDK，Project → New uVision Project，选一个空目录存放工程文件。芯片选择界面里找到 STMicroelectronics → STM32F103 → STM32F103C8，确定后会弹出一个“Copy STM32F10x Startup Code”的对话框，这里选“否”，因为我们要手动添加自己整理好的启动文件。
接下来在 Project 窗口里右键 Target 1 → Manage Project Items，建立四个 Group：
CMSIS：添加core_cm3.c、system_stm32f10x.cFWlib：添加FWlib/src/下你实际用到的外设源文件，比如stm32f10x_gpio.c、stm32f10x_rcc.c、stm32f10x_usart.cUser：添加main.c、stm32f10x_it.cStartup：添加startup_stm32f10x_md.s
添加文件时有个细节：FWlib/src/下有几十个.c文件，不要全加进去。全加会导致编译时间变长，而且有些外设你没用到，编译进去也是浪费。我一般只加 RCC、GPIO、USART、TIM 这几个基础外设，后续需要什么再加。
3.2 头文件路径和宏定义
工程文件加完后，编译大概率会报一堆cannot open source input file。这是因为头文件搜索路径没配。点开 Options for Target → C/C++ → Include Paths，把以下路径加进去：
.\CMSIS .\FWlib\inc .\User三个路径分别对应内核文件、外设头文件和自己写的头文件。路径用相对路径，换电脑或换目录时不容易断。
然后在同一个页面的 Define 框里填入：
STM32F10X_MD, USE_STDPERIPH_DRIVER这两个宏缺一不可。STM32F10X_MD告诉stm32f10x.h当前芯片是中容量，它会据此包含对应的寄存器定义和中断向量；USE_STDPERIPH_DRIVER告诉编译器启用标准外设驱动，否则stm32f10x_conf.h里的配置不会生效。
3.3 时钟配置和 system_stm32f10x.c 的坑
system_stm32f10x.c里有一个SystemInit()函数，它在启动文件里被调用，负责配置系统时钟。默认情况下，如果你的板子用的是 8MHz 外部晶振，SystemInit()会把时钟配到 72MHz。但如果你用的是内部 RC 振荡器，或者外部晶振频率不是 8MHz，就需要改这个文件里的宏定义。
在system_stm32f10x.c开头有一行：
// #define SYSCLK_FREQ_HSE HSE_VALUE // #define SYSCLK_FREQ_24MHz 24000000 // #define SYSCLK_FREQ_36MHz 36000000 // #define SYSCLK_FREQ_48MHz 48000000 // #define SYSCLK_FREQ_56MHz 56000000 #define SYSCLK_FREQ_72MHz 72000000默认是 72MHz。如果你板子上的晶振是 12MHz，不改这里的话，串口波特率会算错，表现为乱码。改完之后，还要确认stm32f10x.h里的HSE_VALUE是否和实际晶振一致，默认是 8000000。
// stm32f10x.h 中 #if !defined HSE_VALUE #define HSE_VALUE ((uint32_t)8000000) /*!< Value of the External oscillator in Hz */ #endif这两个地方要同步改，只改一个还是会出问题。我一般会在main.c里加一句打印系统时钟的代码来验证：
// main.c 中验证时钟配置 #include "stm32f10x.h" #include "stdio.h" int main(void) { // 重定向 printf 到 USART1 的代码省略 printf("SystemCoreClock = %d\r\n", SystemCoreClock); while(1); }如果打印出来是 72000000，说明时钟配置正确。如果是其他值，回去检查晶振频率和宏定义。
3.4 编译选项和下载配置
Options for Target → Output 里勾上“Create HEX File”，方便后续用其他工具烧录。Debug 里选 ST-Link Debugger 或 J-LINK，根据你手上的下载器来。Utilities → Settings 里确认 Flash Download 的算法和芯片容量匹配，中容量选 128K 的算法。
编译前还有一个容易翻车的地方：Keil 的 C 编译器版本。标准库 3.6.0 比较老，用 AC5 编译器没问题，用 AC6 可能会报一些警告甚至错误。如果你用的是 Keil MDK 5.30 以上版本，默认可能是 AC6，可以在 Options for Target → Target → ARM Compiler 里切回 AC5。我一般会保留 AC5，兼容性最稳。
4. 避坑与排查：标准库环境里最常见的五个问题
4.1 编译报错 “core_cm3.h: No such file or directory”
现象：添加完文件、配好路径后编译，提示找不到core_cm3.h。
原因：core_cm3.h在CMSIS/CM3/CoreSupport/下，但很多人只把CMSIS目录加进了 Include Paths，没有把CoreSupport子目录加进去。Keil 不会自动递归搜索子目录。
解决：在 Include Paths 里补上.\CMSIS\CM3\CoreSupport和.\CMSIS\CM3\DeviceSupport\ST\STM32F10x。或者更省事的做法：把core_cm3.c/h、system_stm32f10x.c/h、stm32f10x.h全部复制到CMSIS根目录下，只加一个路径。
4.2 烧录后程序不运行，调试器停在 HardFault
现象：编译无报错，烧录成功，但程序一跑就进 HardFault_Handler。
原因：启动文件选错是最常见的原因。比如中容量芯片用了大容量启动文件，中断向量表偏移不对，一进中断就飞。另一个可能是栈大小不够，启动文件里默认的栈是 0x400，如果用了 RTOS 或者局部变量很大，需要改大。
解决：确认启动文件和芯片容量匹配。如果是栈不够，在启动文件开头找到Stack_Size那一行，改成0x800或更大：
; startup_stm32f10x_md.s 中 Stack_Size EQU 0x000008004.3 串口打印乱码
现象：USART 初始化代码看起来没问题，但串口助手收到的是乱码。
原因：系统时钟和波特率不匹配。标准库的USART_Init()里计算波特率用的是RCC_GetClocksFreq()返回的PCLK1或PCLK2，如果SystemInit()没有正确配置时钟，这个值就是错的。
解决：先确认SystemCoreClock的值是否正确。如果不对，检查system_stm32f10x.c里的SYSCLK_FREQ_72MHz宏和stm32f10x.h里的HSE_VALUE。另外，USART1 挂在 APB2 上，USART2/3 挂在 APB1 上，初始化时USART_Init()会自动处理，但你要确保传入的波特率和串口助手一致。
4.4 中断进不去
现象：配置了 EXTI 或 TIM 中断，但中断服务函数不执行。
原因：stm32f10x_it.c里的中断函数名和启动文件里的向量表名字对不上。标准库的中断函数名是固定的，比如EXTI0_IRQHandler、TIM2_IRQHandler，如果你自己写了一个EXTI0_Handler，链接器找不到对应关系，中断就不会跳转。
解决：打开启动文件，找到对应的中断向量名，复制到stm32f10x_it.c里。另外确认NVIC_Init()里使能了对应的中断通道，并且NVIC_PriorityGroupConfig()在初始化外设之前调用。
4.5 换了芯片型号后编译报错
现象：从 F103C8 换到 F103ZE，改了启动文件和宏定义，但编译报错说某些寄存器未定义。
原因：stm32f10x.h里根据STM32F10X_MD、STM32F10X_HD等宏来条件编译寄存器定义。如果只改了启动文件，没改 Define 里的宏，头文件仍然按中容量编译，大容量芯片特有的寄存器就找不到。
解决：在 Options for Target → C/C++ → Define 里把STM32F10X_MD改成STM32F10X_HD，同时启动文件换成startup_stm32f10x_hd.s。两个地方必须同步改。
5. 装完怎么验证：从点灯到串口回环
5.1 最小验证：GPIO 点灯
环境搭好后，第一件事不是直接上复杂外设，而是写一个最简单的 GPIO 翻转程序，确认编译、烧录、运行这条链路是通的。
// main.c 最小点灯程序 #include "stm32f10x.h" void Delay(__IO uint32_t nCount) { for(; nCount != 0; nCount--); } int main(void) { GPIO_InitTypeDef GPIO_InitStructure; // 使能 GPIOC 时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); // 配置 PC13 为推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOC, &GPIO_InitStructure); while(1) { GPIO_SetBits(GPIOC, GPIO_Pin_13); // 熄灭 Delay(800000); GPIO_ResetBits(GPIOC, GPIO_Pin_13); // 点亮 Delay(800000); } }这段代码里，RCC_APB2PeriphClockCmd使能 GPIOC 的时钟，没有这一句 GPIO 不会工作。GPIO_Mode_Out_PP是推挽输出模式，驱动 LED 足够。GPIO_Speed_50MHz影响引脚翻转速率，点灯场景下用 2MHz 也行，但 50MHz 是常见默认值。
烧录后如果 LED 按 1Hz 左右闪烁，说明时钟配置、启动文件、GPIO 驱动都正常。如果不亮，先量一下 PC13 的电压有没有变化，再回去查时钟和启动文件。
5.2 串口回环测试
点灯通过后，加一个串口验证。把 USART1 的 TX 和 RX 短接，发什么收什么，确认波特率和中断都正常。
// 串口回环测试关键代码 void USART1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE); // PA9 TX 复用推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // PA10 RX 浮空输入 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); USART_InitStructure.USART_BaudRate = 115200; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &USART_InitStructure); USART_Cmd(USART1, ENABLE); }TX 引脚必须配成GPIO_Mode_AF_PP，也就是复用推挽输出，配成普通推挽输出发不出数据。RX 配成浮空输入或上拉输入都行。波特率 115200 是常用值，如果串口助手收到乱码，先检查系统时钟是不是 72MHz，再检查波特率是否一致。
回环测试通过后，把 TX 和 RX 的短接帽拔掉，接上 USB 转串口模块，就可以和电脑通信了。这一步过了，说明标准库的 USART 驱动、中断向量、时钟配置全部正确。
5.3 我每次装完都会走一遍的检查清单
从那以后我每次搭完标准库环境，都会按这个顺序过一遍，五分钟内能定位到大部分配置问题：
| 检查项 | 预期结果 | 出问题先看 |
|---|---|---|
| 编译无报错 | 0 Error, 0 Warning | Include Paths、Define 宏 |
| SystemCoreClock 打印 | 72000000 | system_stm32f10x.c、HSE_VALUE |
| GPIO 点灯 | LED 闪烁 | 启动文件、RCC 时钟使能 |
| 串口回环 | 收发一致 | GPIO 模式、波特率 |
| 中断触发 | 进服务函数 | 中断向量名、NVIC 配置 |
这套流程走完，基本能确认环境是健康的。后面加定时器、ADC、SPI 这些外设，无非是在stm32f10x_conf.h里取消对应注释，在工程里添加对应的.c文件，再配一下 GPIO 和时钟。标准库 3.6.0 虽然老，但它的结构足够清晰，一旦跑通一次，后面就是重复同样的模式。
希望帮到你。
本文还有配套的精品资源，点击获取
