企业官网建设流程全解析

简介：STM32F10x标准库3.6.0最终版是ST官方为STM32F10X系列推出的标准外设库，面向使用STM32芯片进行嵌入式开发的工程师、高校学生及电子爱好者。它把底层寄存器操作封装成库函数，开发者无需逐位配置寄存器，直接调用即可完成GPIO、定时器、串口、ADC等外设功能，能显著降低开发门槛、提升代码可读性与可移植性，适合从入门到进阶的固件开发场景。资源包共960个文件，约21.25MB，以349个c源文件与277个h头文件为主体，另含txt说明、s汇编、lsl链接脚本、ld与icf分散加载文件、uvproj与ewp等工程文件，覆盖IAR、Keil等主流工具链，并附有操作说明书与chm帮助文档。目前已有2820人学习下载。借助这套完整库文件与配套说明，读者可快速搭建标准工程模板，理解外设驱动结构，对照示例完成项目移植与调试，是学习STM32固件开发的实用参考。

1. 从一块“点不亮”的板子说起：为什么我还在用 STM32F10x 标准库 3.6.0

上周帮一个学弟看他那块 STM32F103C8T6 最小系统板，现象很典型：Keil 里编译零错误零警告，下载器也认芯片，可就是 LED 不闪，串口一个字节都吐不出来。他装的是最新版的 CubeMX 加 HAL 库，引脚配置界面点得飞起，但生成代码后连SystemInit里的时钟树都没配对，外部晶振被当成内部 HSI 跑，主频卡在 8MHz，延时函数全乱套。这种“环境装好了、代码也下了、就是跑不起来”的玄学现场，我每年都要碰上好几回。

STM32F10x 标准库 3.6.0 是 ST 官方在 2011 年前后放出的最后一个标准外设库版本，覆盖 F101/102/103/105/107 全系。它不像 HAL 那样层层抽象，寄存器操作直给，启动文件、时钟配置、外设驱动全在源码里摊开，特别适合想搞明白“芯片到底怎么动起来”的人。但它的安装和工程搭建有一套固定套路，版本选错、启动文件拿错、宏定义漏写，都会让你卡在“编译通过但运行异常”的坑里。这篇笔记就把这套环境的搭建过程从头到尾捋一遍，从下载哪个包、Keil 里怎么配、到跑通第一个串口输出，每一步都落到能直接抄的命令和配置上。

2. 装前准备：STM32F10x 标准库 3.6.0 的获取与目录结构

2.1 版本确认与下载渠道

标准库 3.6.0 的官方包名通常叫STM32F10x_StdPeriph_Lib_V3.6.0，压缩后大概 20MB 出头，解压后接近 100MB。网上流传的版本很杂，有 3.5.0 改的、有把启动文件替换过的，我一般只认两种来源：一是 ST 官网历史归档区（需要注册账号，但文件最干净），二是某些高校实验室或开源镜像站里带 MD5 校验的副本。下载完先对一下压缩包内Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/下的stm32f10x.h，看版本注释是不是V3.6.0，再确认startup/arm/目录里启动文件齐全。

提示：如果拿到的是V3.5.0改名的包，stm32f10x.h里会缺STM32F10X_MD之外的密度定义，编译时容易报#error "Please select first the target STM32F10x device used in your application"。

2.2 解压后的目录该看哪几个

解压后目录结构大致如下，我按重要性排个序：

我一般会把Libraries整个拷到工程目录下，Project里的模板只用来对照启动文件和中断向量表的写法，不直接拿来编译。这样工程目录干净，换芯片型号时只改宏定义和启动文件，不用动库本身。

2.3 工具链版本选择：Keil MDK 用哪个版本不翻车

标准库 3.6.0 对编译器版本不挑，但 Keil MDK 从 5.30 之后默认的 ARM Compiler 6 对老库的汇编启动文件支持有变化。我实测下来，MDK 5.28 到 5.36 配 ARM Compiler 5最稳，启动文件startup_stm32f10x_md.s直接能编。如果只有新版 MDK，需要在Options for Target → Target里把编译器切回Use default compiler version 5，或者手动指定ARMCC路径。

# 检查 Keil 安装目录下是否有 ARMCC 文件夹（Compiler 5 的标志） ls "C:/Keil_v5/ARM/ARMCC/bin/armcc.exe" # 如果只有 ARMCLANG，说明默认是 Compiler 6，需要单独装 Legacy Support

上面这条命令用来确认编译器版本。ARMCC是 Compiler 5 的可执行文件，ARMCLANG是 Compiler 6。标准库 3.6.0 的启动文件里用了AREA、DCD这类 ARM 汇编伪指令，Compiler 6 虽然兼容大部分，但个别分散加载文件会报错。我一般直接装 Keil 的 Legacy Support 包，省得改启动文件。

3. 工程搭建：从零建一个能编译的 STM32F10x 标准库工程

3.1 新建工程与芯片型号选择

打开 Keil MDK，Project → New uVision Project，选一个空目录，芯片型号选STMicroelectronics → STM32F103C8（如果是其他容量，按实际选，比如STM32F103ZE）。弹窗问是否复制Startup文件时选否，因为我们要用标准库自带的启动文件，不用 Keil 的。

建完工程后，目录树里只有一个Target 1，下面空荡荡。接下来手动建分组：右键Target 1 → Manage Project Items，建这几个组：

• Startup：放启动文件
• CMSIS：放内核和系统文件
• StdPeriph_Driver：放外设驱动
• User：放main.c、中断处理、配置文件

分组名随意，但建议按这个来，后面换芯片时一眼能看出哪个组要动。

3.2 添加文件：哪些 .c 必须加，哪些可以不加

往各组里加文件时，最容易漏的是system_stm32f10x.c和stm32f10x_it.c。我列一下最小系统的文件清单：

# Startup 组（根据芯片容量选一个） Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/startup/arm/startup_stm32f10x_md.s # CMSIS 组 Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/system_stm32f10x.c Libraries/CMSIS/CM3/CoreSupport/core_cm3.c # StdPeriph_Driver 组（按需加，这里以 GPIO、USART、RCC 为例） Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_gpio.c Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_usart.c Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_rcc.c # User 组 Project/STM32F10x_StdPeriph_Template/stm32f10x_it.c # main.c 自己新建

启动文件的选择看芯片容量：md是中容量（64KB/128KB Flash），hd是大容量（256KB以上），ld是小容量（32KB以下）。选错了会在链接阶段报No section matches selector或者中断向量表对不上，程序跑飞。core_cm3.c在新版库里其实可以不加，因为core_cm3.h里已经用__INLINE内联了大部分函数，但加上也不影响，我习惯留着。

3.3 头文件路径与宏定义：两个必须配的地方

文件加完后，点Options for Target → C/C++，在Include Paths里加这几条：

.\Libraries\CMSIS\CM3\CoreSupport .\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x .\Libraries\STM32F10x_StdPeriph_Driver\inc .\User

然后在Define框里填两个宏：

USE_STDPERIPH_DRIVER, STM32F10X_MD

USE_STDPERIPH_DRIVER是告诉stm32f10x.h去包含stm32f10x_conf.h，不加的话标准库的外设函数声明不会展开。STM32F10X_MD是芯片密度定义，必须和启动文件匹配。如果是大容量芯片，改成STM32F10X_HD；小容量改STM32F10X_LD。

注意：这两个宏之间用英文逗号分隔，不要用中文逗号，否则 Keil 会把它当成一个整体宏，编译时报identifier "USE_STDPERIPH_DRIVER, STM32F10X_MD" is undefined。

3.4 时钟配置：system_stm32f10x.c 里改哪一行

标准库默认用外部 8MHz 晶振，PLL 倍频到 72MHz。如果你板子上是 12MHz 晶振或者用内部 HSI，需要改system_stm32f10x.c里的SetSysClockTo72()函数。我一般不动这个文件，而是在main.c开头调用SystemInit()后，用RCC_GetClocksFreq()读一下实际频率，确认时钟树对了再往下跑。

#include "stm32f10x.h" #include "stm32f10x_rcc.h" int main(void) { SystemInit(); // 初始化时钟，默认 72MHz RCC_ClocksTypeDef clocks; RCC_GetClocksFreq(&clocks); // 如果 clocks.SYSCLK_Frequency 不是 72000000，说明晶振或 PLL 配置有问题 while (1) { // 主循环 } }

SystemInit()在启动文件里被Reset_Handler调用，执行的是system_stm32f10x.c里的时钟初始化。RCC_GetClocksFreq()把当前各总线频率填进结构体，调试时在 Watch 窗口看clocks.SYSCLK_Frequency最直接。如果读出来是 8000000，说明外部晶振没起振，程序自动切回了 HSI。

4. 外设驱动配置：GPIO、USART 和中断的落地写法

4.1 GPIO 初始化：结构体里每个成员的含义

标准库的 GPIO 初始化靠GPIO_InitTypeDef结构体，填完传给GPIO_Init()。以点亮 PC13 的 LED 为例：

GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); // 开 GPIOC 时钟 gpio.GPIO_Pin = GPIO_Pin_13; gpio.GPIO_Speed = GPIO_Speed_50MHz; // 输出速度，LED 用 2MHz 也行 gpio.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出 GPIO_Init(GPIOC, &gpio); GPIO_SetBits(GPIOC, GPIO_Pin_13); // 输出高电平，灭灯（取决于硬件接法）

RCC_APB2PeriphClockCmd必须放在GPIO_Init之前，否则寄存器写不进去，现象就是“程序在跑但引脚没反应”。GPIO_Speed只在输出模式下有意义，输入模式下随便填。GPIO_Mode常用值：GPIO_Mode_Out_PP推挽输出、GPIO_Mode_IPU上拉输入、GPIO_Mode_AIN模拟输入。我见过有人把 LED 配成GPIO_Mode_IPU，然后纳闷为什么灯不亮——模式选错了，引脚根本没往外驱动。

4.2 USART 配置：波特率算不对的排查思路

串口是调试阶段最重要的外设。标准库配 USART1 的代码如下：

USART_InitTypeDef usart; GPIO_InitTypeDef gpio; // PA9 TX, PA10 RX RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); gpio.GPIO_Pin = GPIO_Pin_9; gpio.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽 gpio.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &gpio); gpio.GPIO_Pin = GPIO_Pin_10; gpio.GPIO_Mode = GPIO_Mode_IN_FLOATING; // 浮空输入 GPIO_Init(GPIOA, &gpio); usart.USART_BaudRate = 115200; usart.USART_WordLength = USART_WordLength_8b; usart.USART_StopBits = USART_StopBits_1; usart.USART_Parity = USART_Parity_No; usart.USART_HardwareFlowControl = USART_HardwareFlowControl_None; usart.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &usart); USART_Cmd(USART1, ENABLE);

TX 引脚必须配成GPIO_Mode_AF_PP，RX 配成GPIO_Mode_IN_FLOATING，这是 F1 系列复用功能的固定要求。波特率算不对时，先确认SystemCoreClock是不是 72000000，再看RCC_GetClocksFreq()里PCLK2_Frequency的值。USART1 挂在 APB2 上，如果 APB2 分频不是 1，USART_Init内部算出来的分频系数会偏。我一般把SystemCoreClock在调试时打印出来，确认是 72M 再往下查。

4.3 中断配置：NVIC 优先级分组别乱设

用中断收串口数据时，NVIC 配置容易出问题。标准库的写法：

NVIC_InitTypeDef nvic; NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); // 2 位抢占，2 位响应 nvic.NVIC_IRQChannel = USART1_IRQn; nvic.NVIC_IRQChannelPreemptionPriority = 1; nvic.NVIC_IRQChannelSubPriority = 1; nvic.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&nvic); USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); // 开接收中断

NVIC_PriorityGroupConfig整个工程调一次就行，别在多个文件里重复调，否则后面的会覆盖前面的分组设置。抢占优先级高的可以打断低的，响应优先级只在同抢占级下比较。如果中断进不去，先查USART_ITConfig有没有开对应的中断源，再查NVIC_IRQChannelCmd是不是ENABLE，最后看stm32f10x_it.c里有没有写USART1_IRQHandler。

5. 避坑与排查：标准库 3.6.0 最常见的五个翻车现场

5.1 编译报 “Please select first the target STM32F10x device”

现象：编译时stm32f10x.h里报错，提示没有定义目标芯片。原因：Define里漏了STM32F10X_MD或写成了STM32F10X_MD（带空格）。解决：在Options for Target → C/C++ → Define里补上，注意逗号后不要有空格，写成USE_STDPERIPH_DRIVER,STM32F10X_MD。

5.2 程序下载后不运行，调试器停在 HardFault

现象：Keil 下载成功，但点运行后 PC 指针跳到HardFault_Handler。原因：启动文件和芯片容量不匹配，中断向量表偏移错了；或者system_stm32f10x.c里外部晶振频率和实际不符，PLL 锁不住。解决：确认启动文件后缀（md/hd/ld）和Define里的密度宏一致；用示波器或万用表量晶振引脚，确认起振；临时把SetSysClockTo72()改成SetSysClockToHSI()排除晶振问题。

5.3 串口输出乱码

现象：串口助手收到一堆乱码，或者偶尔对几个字符。原因：波特率不匹配、时钟频率不对、或者 TX/RX 接反。解决：先确认串口助手波特率和代码里一致；再确认SystemCoreClock是 72M；最后交换 TX/RX 线序。我遇到过一块板子晶振是 12M 但代码按 8M 算，PLL 倍频后主频变成 108M，串口分频全乱，改HSE_VALUE宏为12000000就好了。

5.4 外设初始化后没反应

现象：GPIO 不输出、USART 不发数据、定时器不计数。原因：外设时钟没开，或者开了但开错了总线（APB1/APB2）。解决：查RCC_APB1PeriphClockCmd和RCC_APB2PeriphClockCmd的参数。GPIO 全在 APB2，USART1 在 APB2，USART2/3 在 APB1，TIM2~7 在 APB1，TIM1/8 在 APB2。开错总线，寄存器写不进去，现象就是“代码在跑但外设不动”。

5.5 中断服务函数写了但进不去

现象：stm32f10x_it.c里写了USART1_IRQHandler，但断点不命中。原因：中断向量表里的函数名和启动文件里的弱定义对不上，或者 NVIC 没使能。解决：确认函数名拼写和启动文件里DCD USART1_IRQHandler一致；确认NVIC_Init里NVIC_IRQChannelCmd = ENABLE；确认USART_ITConfig开了对应中断源。如果用了USE_STDPERIPH_DRIVER，stm32f10x_it.c里的函数名必须和startup_stm32f10x_md.s里的向量表完全一致，大小写都不能错。

6. 装完怎么验证：从串口打印到 LED 闪烁的完整检查链

环境搭完，别急着写业务代码，先跑一个最小验证程序，把时钟、GPIO、串口、中断四条链路都过一遍。我一般按这个顺序来：

第一步，确认时钟。在main()开头调用SystemInit()后，用RCC_GetClocksFreq()读频率，通过串口打印出来。如果串口还没通，就点灯——用RCC_GetClocksFreq()的结果去算一个精确的软件延时，闪灯频率对了，说明时钟基本对。

第二步，验证 GPIO。写一个最简单的闪灯程序，不调任何库函数，直接操作GPIOB->ODR寄存器翻转。如果寄存器操作能亮，但库函数不亮，说明库文件没加对或者头文件路径有问题。

第三步，打通串口。用USART_SendData()发一个固定字符串，串口助手收到就说明时钟、GPIO 复用、USART 配置全对。收不到就按第 5 章的排查顺序走一遍。

第四步，验证中断。开 USART1 接收中断，发一个字符，在USART1_IRQHandler里翻转另一个 LED。中断能进，说明 NVIC 和向量表都对。

下面这个验证程序把四步串在一起，可以直接抄：

#include "stm32f10x.h" #include "stm32f10x_rcc.h" #include "stm32f10x_gpio.h" #include "stm32f10x_usart.h" void Delay(__IO uint32_t n) { while (n--); } int main(void) { // 1. 时钟验证 SystemInit(); RCC_ClocksTypeDef clocks; RCC_GetClocksFreq(&clocks); // 2. GPIO 初始化：PC13 推挽输出 GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); gpio.GPIO_Pin = GPIO_Pin_13; gpio.GPIO_Speed = GPIO_Speed_2MHz; gpio.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_Init(GPIOC, &gpio); // 3. USART1 初始化：PA9/PA10，115200 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); gpio.GPIO_Pin = GPIO_Pin_9; gpio.GPIO_Mode = GPIO_Mode_AF_PP; gpio.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &gpio); gpio.GPIO_Pin = GPIO_Pin_10; gpio.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &gpio); USART_InitTypeDef usart; usart.USART_BaudRate = 115200; usart.USART_WordLength = USART_WordLength_8b; usart.USART_StopBits = USART_StopBits_1; usart.USART_Parity = USART_Parity_No; usart.USART_HardwareFlowControl = USART_HardwareFlowControl_None; usart.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &usart); USART_Cmd(USART1, ENABLE); // 4. 打印时钟频率 char buf[64]; int len = 0; uint32_t f = clocks.SYSCLK_Frequency / 1000000; buf[len++] = 'S'; buf[len++] = 'Y'; buf[len++] = 'S'; buf[len++] = ':'; buf[len++] = (f / 10) + '0'; buf[len++] = (f % 10) + '0'; buf[len++] = 'M'; buf[len++] = '\r'; buf[len++] = '\n'; for (int i = 0; i < len; i++) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); USART_SendData(USART1, buf[i]); } // 5. 主循环闪灯 while (1) { GPIO_SetBits(GPIOC, GPIO_Pin_13); Delay(7200000); // 约 100ms @72MHz GPIO_ResetBits(GPIOC, GPIO_Pin_13); Delay(7200000); } }

这段代码跑通的标准是：串口助手收到SYS:72M，同时 PC13 上的 LED 以大约 5Hz 的频率闪烁。如果串口收到的是SYS:08M，说明外部晶振没起振，程序跑在 HSI 上，需要检查晶振电路和HSE_VALUE宏。如果串口没输出但灯在闪，说明 GPIO 和时钟没问题，问题在 USART 配置或接线。如果灯也不闪，回到第 5 章从启动文件和宏定义开始查。

从那以后我每次搭标准库工程，都强制先跑一遍这个四步验证链，确认时钟、GPIO、串口、中断全通了再写业务代码。这套流程帮我省掉了至少几十次“编译通过但跑不起来”的无效调试。希望帮到你。

本文还有配套的精品资源，点击获取