STM32F10x标准库3.6.0工程搭建与GPIO/USART中断实战

简介：这份STM32F10x标准库3.6.0最终版面向使用STM32F10x系列MCU的嵌入式开发者，尤其适合不熟悉底层寄存器操作、希望借助官方库函数快速完成外设配置与项目搭建的学习者和工程师。压缩包共960个文件，约21.25MB，以349个c源文件和277个h头文件为主体，配套txt说明文档、s启动汇编、lsl/ld/icf链接脚本及uvproj、ewd、ewp等工程文件，覆盖库源码、工程模板与说明材料。已有2823人学习下载。资料内含操作说明书与完整外设驱动封装，读者可据此理解常用外设模块的库函数用法，快速建立Keil或IAR工程，减少直接操作寄存器的负担，并提升代码可读性与移植效率。适合作为STM32基础开发和外设学习的常备参考包。

1. 从一块点不亮的板子说起：3.6.0 标准库到底解决了什么问题

手上有一块 F103 最小系统板，外设手册翻到 RCC 那一章，光是使能一个 GPIOA 时钟，就要数清楚 APB2ENR 的第 2 位。很多人搜 stm32 软件 插件，真正想找的其实就是这种能直接调用的外设驱动集合——STM32F10x 标准库 3.6.0 最终版干的就是这件事。它把寄存器操作封成RCC_APB2PeriphClockCmd、GPIO_Init这类函数，一个.c文件对应一个外设，工程里用到哪几个就往里加哪几个，没用到的可以直接不加。这套库适合两类人：刚上手 Cortex-M3、不想一上来就啃上千页寄存器手册的新手，和维护十几年前老项目、需要一套能稳定编译的底座的熟手。库本身不绑 IDE，MDK 和 IAR 都能直接挂进去。

2. 目录结构与分层：CMSIS、StdPeriph Driver 和用户代码各自管什么

把包解开，第一眼会看到Libraries、Project、Utilities三个顶层目录。很多人习惯直接打开Project里的模板工程开始改，改到一半发现编译不过，回头又不知道是哪个目录的问题。实际上这套库的分层非常清晰，从下到上依次是内核访问层、外设驱动层、用户应用层，上层只能调用下层，反向依赖一次都不该出现。

2.1 三个目录一棵树：把 Libraries 和 Project 分开看

Libraries/CMSIS管的是 Cortex-M3 内核本身，包括core_cm3.c/h里的 NVIC、SysTick、SCB 操作，system_stm32f10x.c/h里的系统时钟初始化，stm32f10x.h里的全部寄存器映射，以及startup/arm/下那一堆启动汇编文件。这一层只认内核和芯片，不认任何具体外设。

Libraries/STM32F10x_StdPeriph_Driver是真正的驱动层，inc放头文件，src放实现，每个外设一个.c：stm32f10x_gpio.c、stm32f10x_usart.c、stm32f10x_rcc.c、stm32f10x_tim.c、stm32f10x_adc.c……再加一个特殊的misc.c，负责 NVIC 优先级分组和 SysTick 时钟源。Project下面是模板工程和几十个外设例程，Utilities是原厂评估板的驱动，自己画板的话整目录删掉都不影响。

STM32F10x_StdPeriph_Lib_V3.6.0/ ├── Libraries/ │ ├── CMSIS/ │ │ ├── CM3/CoreSupport/ # core_cm3.c/h，内核寄存器 │ │ └── CM3/DeviceSupport/STM32F10x/ │ │ ├── stm32f10x.h # 全片寄存器映射 │ │ ├── system_stm32f10x.c/h # SystemInit、时钟树 │ │ └── startup/arm/ # startup_stm32f10x_xx.s │ └── STM32F10x_StdPeriph_Driver/ │ ├── inc/ # 外设头文件 │ └── src/ # 外设实现 + misc.c ├── Project/ │ ├── STM32F10x_StdPeriph_Template/ # 最小可编译工程 │ └── STM32F10x_StdPeriph_Examples/ # 按外设分的例程 └── Utilities/ # 评估板驱动，可整目录剔除

分层带来的直接好处是裁剪成本低。一个只做串口通信的项目，驱动层只需要stm32f10x_rcc.c、stm32f10x_gpio.c、stm32f10x_usart.c、misc.c四个文件，编译出来的体积比全量加入小一大截。我一般会先按功能列清单，再往工程里加文件，而不是把src目录整个拖进去——后者在改stm32f10x_conf.h做裁剪时特别容易漏，一漏就是编译报未定义。

2.2 头文件里的寄存器映射：stm32f10x.h 是怎么把地址变成结构体的

这套库最值得先看懂的地方，是stm32f10x.h把外设基地址强制转换成了结构体指针。理解这一步，后面所有GPIOA->ODR、USART1->DR的写法都不再是黑匣子。

/* 外设基地址逐级偏移，数值来自芯片存储器映射表 */ #define PERIPH_BASE ((uint32_t)0x40000000) #define APB2PERIPH_BASE (PERIPH_BASE + 0x10000) #define GPIOA_BASE (APB2PERIPH_BASE + 0x0800) /* 结构体成员顺序必须与寄存器偏移严格一致，错一个后面全错位 */ typedef struct { __IO uint32_t CRL; /* 偏移 0x00，低 8 位配置 */ __IO uint32_t CRH; /* 偏移 0x04，高 8 位配置 */ __IO uint32_t IDR; /* 偏移 0x08，输入数据 */ __IO uint32_t ODR; /* 偏移 0x0C，输出数据 */ __IO uint32_t BSRR; /* 偏移 0x10，位设置/清除 */ __IO uint32_t BRR; /* 偏移 0x14，复位 */ __IO uint32_t LCKR; /* 偏移 0x18，配置锁定 */ } GPIO_TypeDef; #define GPIOA ((GPIO_TypeDef *) GPIOA_BASE)

__IO在core_cm3.h里被定义成volatile，编译器不会把它优化进寄存器缓存，轮询标志位时这点很关键。结构体成员一个都不能增删、顺序一个都不能调，否则GPIOA->ODR就会指到别的地址上。这也是换芯片型号时最隐蔽的坑：不同系列的外设寄存器数量不一样，直接用别的系列头文件套，编译能过，跑起来全是玄学。

还有一层是条件编译。stm32f10x.h顶部会根据STM32F10X_LD/MD/HD/XL/CL这几个宏决定包含哪些外设定义、中断号开到第几个。宏没定义，编译直接报一堆GPIO_TypeDef未声明——这不是库坏了，是型号没告诉编译器。

2.3 启动文件与宏定义：容量型号对不上，程序从第一条指令就跑飞

startup/arm/目录下有一组汇编文件，名字后缀对应 Flash 容量。启动文件里干三件事：定义中断向量表、初始化栈顶指针、在Reset_Handler里调用SystemInit再跳到main。选错文件，向量表长度和实际芯片对不上，中断一进就飞。

Reset_Handler里那句调用是固定写法：

Reset_Handler PROC EXPORT Reset_Handler [WEAK] IMPORT __main IMPORT SystemInit LDR R0, =SystemInit BLX R0 ; 先跑时钟和向量表重定位 LDR R0, =__main BX R0 ; 再进 C 库启动、到 main ENDP

注意这里SystemInit是在main之前执行的，所以进main时主频已经是system_stm32f10x.c里配好的值，不需要在main里再手动调一次。反过来，如果自己重写了一个SystemInit却没接上，或者干脆把system_stm32f10x.c从工程里删了，链接阶段就会报SystemInit未定义——这个报错其实是在提醒你启动链条断了。

3. 工程搭建实战：从零建一个能编译能下载的 Keil 工程

模板工程能直接编译，但多数人最后还是要自己建一个干净工程。自己建的好处是文件清单、宏、包含路径全部心里有数，出问题知道从哪查。这一段按顺序走一遍，每一步都给可对照的配置。

3.1 文件清单与分组：哪些 .c 必须加，哪些可以不加

新建工程后先建分组，我一般按CMSIS、StdPeriph、User三层分。必加项只有四个：启动汇编、system_stm32f10x.c、misc.c（只要用中断就得加）、stm32f10x_it.c（中断服务函数集中放这里，也可以自己另建文件）。剩下按外设逐个加，比如点灯加stm32f10x_rcc.c和stm32f10x_gpio.c，串口再加stm32f10x_usart.c。

包含路径要覆盖三个地方：Libraries/CMSIS/CM3/CoreSupport、Libraries/CMSIS/CM3/DeviceSupport/STM32F10x、Libraries/STM32F10x_StdPeriph_Driver/inc，最后再加自己的User目录。少一个就是cannot open source input file，报错信息里会直接写文件名，照着补路径就行。

stm32f10x_conf.h这个文件容易忽略，它决定了驱动层头文件怎么互相包含。模板里默认把十几个外设的#include全打开了，实际项目里没用到的可以注释掉，编译能快不少。更关键的是它控制assert_param：

/* 取消下面这行的注释即可开启参数检查，调试期建议打开 */ /* #define USE_FULL_ASSERT 1 */ #ifdef USE_FULL_ASSERT #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__)) void assert_failed(uint8_t* file, uint32_t line); #else #define assert_param(expr) ((void)0) #endif

assert_param会在每次库函数调用时校验参数合法性，比如GPIO_Init里检查GPIO_Pin是不是合法位掩码。调试期打开能把一堆传错枚举值的问题提前暴露，发布前关掉省空间。我一般只在调试构建里开，assert_failed里点个灯或者打条串口，比单步调试快。

3.2 编译宏与包含路径：USE_STDPERIPH_DRIVER 不是可选装饰

工程选项的 C/C++ 预处理宏里要写两个：USE_STDPERIPH_DRIVER和型号宏（如STM32F10X_HD）。少写第一个，stm32f10x.h里那段条件包含就不会生效，stm32f10x_conf.h根本不会被引进来，结果是一堆驱动函数声明找不到。

/* stm32f10x.h 末尾附近，控制是否引入用户配置文件 */ #ifdef USE_STDPERIPH_DRIVER #include "stm32f10x_conf.h" #endif

这段逻辑的意思是：库本身不知道你用了哪些外设，靠这个宏把决定权交给工程。写型号宏的作用前面提过，决定寄存器定义和中断号范围。两个宏都写对，编译才不会有"函数隐式声明"这类警告——隐式声明在 C89 下只是警告，链接时才会变成找不到符号，排查起来绕远路。

晶振频率也在这附近定：

/* 默认按 8MHz 外部晶振算，板子上是别的值必须改 */ #ifndef HSE_VALUE #define HSE_VALUE ((uint32_t)8000000) #endif

这个值直接参与SystemInit里的 PLL 倍频计算和串口波特率分频。板子焊的是 12MHz 却留着 8000000，编译一切正常，串口打印出来全是乱码，属于典型的现象和原因隔了好几层。

3.3 时钟与 SystemInit：72MHz 是怎么一步步配出来的

system_stm32f10x.c里的SetSysClockTo72是整棵时钟树的核心。流程是：开 HSE → 等 HSE 稳定 → 配 Flash 等待周期 → 设 AHB/APB 分频 → 配 PLL 倍频和时钟源 → 切系统时钟到 PLL → 等切换完成。

static void SetSysClockTo72(void) { __IO uint32_t StartUpCounter = 0, HSEStatus = 0; /* 1. 使能外部高速晶振 */ RCC->CR |= ((uint32_t)RCC_CR_HSEON); do { HSEStatus = RCC->CR & RCC_CR_HSERDY; StartUpCounter++; } while((HSEStatus == 0) && (StartUpCounter != HSE_STARTUP_TIMEOUT)); if ((RCC->CR & RCC_CR_HSERDY) != RESET) { /* 2. 72MHz 下 Flash 需要 2 个等待周期，否则取指出错 */ FLASH->ACR |= FLASH_ACR_PRFTBE; FLASH->ACR &= (uint32_t)((uint32_t)~FLASH_ACR_LATENCY); FLASH->ACR |= (uint32_t)FLASH_ACR_LATENCY_2; /* 3. AHB 不分频，APB1 二分频最高 36MHz，APB2 不分频 72MHz */ RCC->CFGR |= (uint32_t)RCC_CFGR_HPRE_DIV1; RCC->CFGR |= (uint32_t)RCC_CFGR_PPRE1_DIV2; RCC->CFGR |= (uint32_t)RCC_CFGR_PPRE2_DIV1; /* 4. PLL 源选 HSE，8MHz x 9 = 72MHz */ RCC->CFGR &= (uint32_t)((uint32_t)~(RCC_CFGR_PLLSRC | RCC_CFGR_PLLXTPRE | RCC_CFGR_PLLMULL)); RCC->CFGR |= (uint32_t)(RCC_CFGR_PLLSRC_HSE | RCC_CFGR_PLLMULL9); RCC->CR |= RCC_CR_PLLON; while((RCC->CR & RCC_CR_PLLRDY) == 0) {} /* 5. 切换系统时钟源，并等待切换成功 */ RCC->CFGR &= (uint32_t)((uint32_t)~(RCC_CFGR_SW)); RCC->CFGR |= (uint32_t)RCC_CFGR_SW_PLL; while ((RCC->CFGR & (uint32_t)RCC_CFGR_SWS) != (uint32_t)0x08) {} } else { /* HSE 起振失败，这里通常停在死循环，方便定位硬件问题 */ while (1) {} } }

几个参数值得单独说。FLASH_ACR_LATENCY_2是 48MHz 以上必须的等待周期，主频拉到 72MHz 却没改这个值，程序偶尔跑飞、偶尔正常，是最难查的一类问题。APB1 必须二分频，因为它的上限就是 36MHz，超了外设行为不可预测。倍频系数RCC_CFGR_PLLMULL9是按 8MHz 输入算的，换晶振要跟着改，或者干脆改成RCC_CFGR_PLLSRC_HSI_Div2走内部 8MHz 振荡器。

SystemCoreClock这个全局变量由SystemInit更新，后面配 SysTick 延时、算波特率都要读它。自己改了时钟配置却没同步这个变量，SysTick_Config算出来的延时能差好几倍。

4. 核心模块拆解：GPIO、USART 与中断的完整调用链路

驱动层的函数模式高度统一：先开时钟，再填初始化结构体，然后调用XXX_Init，最后按需开中断。把这三个外设走通，剩下的 ADC、TIM、SPI 基本是同一套模板换个结构体。

4.1 GPIO 初始化：一个结构体背后的时钟、模式和速度

void LED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; /* 第一步永远是开时钟，APB2 上挂 GPIOA~GPIOG */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; /* 第 13 号引脚 */ GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; /* 推挽输出 */ GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; /* 输出翻转速率 */ GPIO_Init(GPIOC, &GPIO_InitStructure); /* 默认输出高电平，LED 低电平点亮则先熄灭 */ GPIO_SetBits(GPIOC, GPIO_Pin_13); }

GPIO_Mode一共八种：GPIO_Mode_AIN（模拟输入，ADC 用）、GPIO_Mode_IN_FLOATING（浮空输入）、GPIO_Mode_IPD/GPIO_Mode_IPU（下拉 / 上拉输入）、GPIO_Mode_Out_OD/GPIO_Mode_Out_PP（开漏 / 推挽输出）、GPIO_Mode_AF_OD/GPIO_Mode_AF_PP（复用开漏 / 推挽）。串口 TX 必须选AF_PP，I2C 的 SDA 选AF_OD，选错了波形出不来但编译毫无提示。

GPIO_Speed影响的是输出驱动电路的翻转速率，不是"跑多快"。速度越高边沿越陡、EMI 越大，低速场合选 2MHz 就够。这点新手常误解，以为设 50MHz 能让 IO 翻转更快。

还有一处容易漏：用 PB3、PB4、PA15 这几个脚时，它们是 JTAG 引脚复用，得先关掉 JTAG 再当普通 IO 用。

/* 复用引脚重映射前，AFIO 时钟必须先开 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); /* 保留 SWD，释放 PB3/PB4/PA15 */

GPIO_Remap_SWJ_JTAGDisable保留 SWD 两线，关掉 JTAG。如果误选了GPIO_Remap_SWJ_Disable，调试器下次就连不上了，只能靠拉 BOOT 引脚救回来，这个坑后面还会提。

4.2 USART 收发与 printf 重定向

void USART1_Init(uint32_t baudrate) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; /* PA9=TX 复用推挽，PA10=RX 浮空或上拉输入 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE); 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); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); USART_InitStructure.USART_BaudRate = baudrate; 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); }

结构体六个参数要和上位机严格一致：8 位数据、1 位停止、无校验，这是串口助手默认值。波特率能配准的前提是SystemCoreClock和HSE_VALUE都对，否则分频系数算偏，接收端全是乱码。

重定向printf只需要补一个fputc，但发送顺序有讲究：

/* MDK 下重定向到 USART1，需在工程里勾选 MicroLIB */ int fputc(int ch, FILE *f) { /* 先等发送寄存器空，再写数据，避免覆盖上一字节 */ while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); USART_SendData(USART1, (uint8_t)ch); return ch; }

先等TXE再写DR，和先写再等，在低速波特率下差别不大，但连续高速打印时前者更稳。TXE表示数据已经从DR搬进移位寄存器，可以写下一个字节了；想知道整帧是否发完要看TC标志。用printf做调试输出时，记得勾选微库，否则会拉进标准库的printf全家桶，Flash 直接涨几 K。

4.3 NVIC 与中断向量：从 EXTI 到服务函数的名字匹配

标准库里中断配置分两步：misc.c里的NVIC_PriorityGroupConfig定分组，stm32f10x_exti.c配触发源，最后NVIC_Init挂上去。

void EXTI0_Config(void) { EXTI_InitTypeDef EXTI_InitStructure; NVIC_InitTypeDef NVIC_InitStructure; /* 外部中断必须开 AFIO 时钟 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); /* PA0 映射到 EXTI0，同一编号的引脚只能有一个口占用 */ GPIO_EXTILineConfig(GPIO_PortSourceGPIOA, GPIO_PinSource0); EXTI_InitStructure.EXTI_Line = EXTI_Line0; EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt; /* 中断而非事件 */ EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Falling; /* 下降沿触发 */ EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure); /* 整个工程只配一次分组，通常放在 main 开头 */ NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); NVIC_InitStructure.NVIC_IRQChannel = EXTI0_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; /* 抢占优先级 */ NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1; /* 响应优先级 */ NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure); }

NVIC_PriorityGroup_2表示 4 位优先级里 2 位给抢占、2 位给响应，抢占级 0~3、响应级 0~3。抢占级不同才能嵌套，响应级不同只影响同时挂起时的排队顺序。这个分组全局只能设一次，后面再调用会覆盖前面的配置，多个人协作时最容易在各自的初始化函数里各设一遍，结果谁最后跑谁说了算。

中断服务函数的名字必须和启动文件里向量表的名字一模一样：

/* 函数名与 startup 文件中的 EXTI0_IRQHandler 对应，写错就进默认死循环 */ void EXTI0_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line0) != RESET) { /* 业务代码，尽量短 */ EXTI_ClearITPendingBit(EXTI_Line0); /* 不清标志会反复进中断 */ } }

启动文件里每个向量都是[WEAK]弱定义，指向一个死循环。自己写的函数名拼错一个字母，链接器不会报错，弱定义生效，中断一来就跳进死循环出不来。这是新手最常见的"程序卡死"来源之一。

5. 常见问题排查：五个让新手卡一整天的坑

5.1 启动文件选错，程序一上电就进 HardFault

现象：编译零错误零警告，下载后程序不跑，用调试器暂停发现停在HardFault_Handler里，或者连main都没进去。

原因：启动文件后缀和芯片 Flash 容量不匹配。比如 128K 的片子用了startup_stm32f10x_hd.s，向量表比实际中断源长，栈顶初始值取的地址超出 RAM 范围；反过来用ld的文件跑大容量片子，中断号靠后的外设中断根本找不到入口。

解决：先确认芯片具体型号和 Flash 大小，对照 2.3 那张表选文件，同时把型号宏一起改掉。两者必须成对出现，只改一个等于没改。改完记得全量重编译，有些 IDE 对汇编文件增量编译处理得不好。

5.2 宏定义与器件型号不匹配，报一堆未定义

现象：stm32f10x.h里报GPIO_TypeDef未定义，或者RCC_APB2Periph_GPIOB找不到，错误动辄上百条。

原因：型号宏没加，或者加成了别的系列。stm32f10x.h开头有一段条件编译，没检测到任何STM32F10X_XX宏时会插入#error提示，但有些人把这段提示注释掉了继续编，后面就崩了。

解决：工程预处理宏里补上STM32F10X_HD（按实际容量选）和USE_STDPERIPH_DRIVER两个，注意宏之间用英文逗号或空格分隔，别用中文标点。改完清一次编译缓存，确认头文件确实重新处理过。

5.3 外设时钟没使能，寄存器写进去毫无反应

现象：GPIO_Init调用完，读回GPIOA->CRL发现值没变；或者串口初始化全部成功，就是发不出数据。

原因：STM32 的外设时钟默认全关，不开时钟，外设寄存器写入被硬件忽略，不报错也不异常，属于最难察觉的一类。GPIO 挂在 APB2，USART1 也在 APB2，USART2/3 却在 APB1，很多人以为串口都在一个总线上。

解决：每个外设初始化函数第一行固定写RCC_AHBPeriphClockCmd/RCC_APB1PeriphClockCmd/RCC_APB2PeriphClockCmd，总线别搞混。调试时先读RCC->APB2ENR确认对应位是不是 1，比盲猜快得多。用 AFIO 重映射、外部中断的场合，AFIO 时钟也别忘了。

5.4 中断优先级分组混乱，嵌套不生效

现象：低优先级中断服务函数执行期间，高优先级中断进不来；或者两个中断同时挂起时，顺序和预期相反。

原因：NVIC_PriorityGroupConfig被多处调用，后调用的覆盖前面的；或者分组设成Group_2却按Group_0的思路填了抢占优先级 3，实际有效位只有 2 位，高位被截断。

解决：分组只在main开头调一次，其它地方一律不碰。填优先级之前先算清楚当前分组下抢占级和响应级各有几位。用NVIC_GetPriorityGrouping()在调试时打印一下当前分组，能省很多来回。中断服务函数里只清自己那一位标志，别顺手清一片。

5.5 printf 卡死、串口乱码、调试器连不上

现象一：加了printf后程序跑着跑着不动了，调试器暂停发现卡在fputc里。原因是没有勾选微库，或者TXE标志判断写反。解决是勾上 MicroLIB，确认while循环等的是TXE == RESET而不是SET。

现象二：串口助手上全是乱码。原因通常是HSE_VALUE和实际晶振不一致，波特率分频算错。改宏、重编译，用示波器量一下 TX 波形宽度能直接算出实际波特率。

现象三：烧录正常，第二次想连调试器连不上。原因是代码里调了GPIO_PinRemapConfig(GPIO_Remap_SWJ_Disable, ENABLE)，把 SWD 一起关了。解决是改用GPIO_Remap_SWJ_JTAGDisable，或者按住复位键在复位释放的瞬间下载，把这段代码刷掉。改引脚复用之前，我都习惯先确认板子上有 BOOT0 跳线能兜底。

6. 二次开发：在 3.6.0 上封一层自己的板级支持包

直接把GPIO_Init写在业务代码里，项目一过三千行就没法维护了。我一般的做法是不动Libraries目录一个字，在工程里另建一个BSP分组，把板子上所有硬件抽象成board_xxx_init和几个读写函数。

/* bsp_board.h：业务层只认这些函数，不认标准库类型 */ void board_init(void); /* 时钟 + 全部板载外设 */ void led_set(uint8_t idx, uint8_t on); void uart_send(const uint8_t *buf, uint16_t len);

board.c内部才是RCC_APB2PeriphClockCmd、GPIO_Init这一套，头文件里一个标准库类型都不往外露。好处是将来换到别的系列，业务代码一行不改，只重写board.c。stm32f10x_conf.h也跟着项目裁剪，没用到的外设注释掉，编译时间明显下降。

验证顺序我固定三步：先点灯，确认时钟和 GPIO 链路通；再接串口，printf打出主频和编译时间；最后开一个定时器中断，看能否稳定计数。三步都过，说明启动文件、宏、时钟树、中断分组这四件事全对，后面加任何外设都在这个地基上。

还有一条血泪经验：Libraries目录一旦定版就不要改，哪怕发现某个库函数有瑕疵，也放到应用层包一层绕过去。改库的后悔药很难吃——下次换人接手，或者重新拉一份 3.6.0，改动全没了，现象复现都复现不了。每次新建工程，我都强制走一遍点灯、串口、定时器这三步验证，确认地基稳了再写业务。希望帮到你。

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