企业官网建设流程全解析

简介：STM32F303基础工程文件是一套面向嵌入式初学者和中级开发者的裸机工程模板，围绕Cortex-M4内核的STM32F303芯片，帮助读者快速搭建可编译、可调试的项目骨架，并理解启动流程、系统时钟初始化与外设驱动组织方式。压缩包共353个文件、约3.6MB，以40个头文件、30个C源文件、9个汇编启动文件及若干目标文件和依赖文件为主体，另有Keil工程配置、网页说明与截图等辅助资料，覆盖TIM、ADC、RTC、USART、I2C、RCC、CAN、SPI等常用外设。读者可从中获得启动代码、链接脚本、时钟树配置、外设库调用和编译选项的参考实现，便于对照学习工程目录结构、理解中断向量表与内存布局、移植驱动并排查编译链接问题。已有694人学习下载，适合作为STM32F303项目起步、课程实验与驱动入门的基础模板，也可为工业控制、物联网终端等场景提供参考。

1. 从一块 48 脚核心板说起

拿到一块 48 脚的 STM32F303CC 核心板，多数人的第一反应是打开 IDE 新建工程，然后半个下午就耗在启动文件选哪份、晶振倍频怎么填、下载算法匹配不上这几件事上。这份 STM32F303基础工程文件要解决的就是这段路：把复位向量、时钟树、GPIO 翻转、SysTick 心跳、串口打印这几块地基提前铺好，让拿到板子的人第一件事是写业务逻辑，而不是对着 HardFault 发呆。

它适合两类人。一类是刚接触 F3 系列、想先点个灯跑通链路的新手，工程里的目录结构和注释能把“上电到我写的第一行 main 之间发生了什么”讲明白。另一类是手上有现成 F303 项目、需要一份干净底座做二次开发的老手，工程里外设初始化、中断分组、用户代码保护区都是分开的，剪裁起来不牵连。F303 这块片子带 Cortex-M4F 内核、硬件浮点、四路 12 位 ADC 和片内运放比较器，做电机控制、电流采样、传感器前端都够用，而这套基础工程正好卡在这些场景的最小可运行点上。

2. 工程骨架解剖：从复位向量到 main 的启动链路

2.1 目录结构：一份 F303 基础工程里都有什么

打开工程先看目录，不要急着点编译。基础工程的目录划分基本决定了后面半年你找文件时的痛苦程度，一份合理的骨架长这样：

F303_Base/ ├── CMSIS/ │ ├── core_cm4.h # 内核寄存器与 NVIC 定义 │ └── system_stm32f3xx.c # SystemInit / SystemCoreClock 更新 ├── Drivers/ │ ├── CMSIS/Device/... │ └── STM32F3xx_HAL_Driver/ # HAL 外设驱动源文件 ├── Inc/ │ ├── main.h │ ├── stm32f3xx_hal_conf.h # HAL 模块裁剪开关 │ └── stm32f3xx_it.h # 中断服务函数声明 ├── Src/ │ ├── main.c │ ├── stm32f3xx_it.c # 所有 IRQHandler 的落地处 │ └── system_stm32f3xx.c ├── Startup/ │ └── startup_stm32f303xc.s # 启动汇编，注意 xc 后缀 ├── MDK-ARM/ │ ├── F303_Base.uvprojx │ └── F303_Base.sct # 分散加载描述 └── BSP/ ├── bsp_led.c / bsp_led.h └── bsp_uart.c / bsp_uart.h

这里有个很关键的命名细节：启动文件后缀xc对应 256KB Flash 的 F303CC，x8对应 64KB，xb对应 128KB。三者向量表长度和 Flash 起始地址相同，但链接时的 ROM 尺寸不同，选错了编译器不一定报错，运行时才炸。stm32f3xx_hal_conf.h是 HAL 的裁剪总闸，用不到的外设模块把对应HAL_XXX_MODULE_ENABLED注释掉，能砍掉一大截编译时间和 Flash 占用，这一点在 256KB 的片子上尤其值得做。

BSP这一层是我建议在基础工程里就留出来的。HAL 负责寄存器级抽象，BSP 负责板级语义：LED 接在 PA5、按键接在 PC13、串口用 USART2 的 PA2/PA3，这些“板子相关”的信息集中在 BSP 层，换一块板子只改 BSP，不动业务代码。

2.2 启动文件：栈、堆和向量表这三段决定了能不能跑起来

startup_stm32f303xc.s是上电后执行的第一段代码，它做的事情不多，但每一件都不能错。开头几行定义了栈和堆的实际大小：

; 栈大小，默认 1KB。中断嵌套深或局部数组大时必须调大 Stack_Size EQU 0x00000400 AREA STACK, NOINIT, READWRITE, ALIGN=3 Stack_Mem SPACE Stack_Size __initial_sp ; 堆大小，只有调用 malloc 才用得上，走 HAL 的项目一般 512B 足够 Heap_Size EQU 0x00000200 AREA HEAP, NOINIT, READWRITE, ALIGN=3 __heap_base Heap_Mem SPACE Heap_Size __heap_limit

Stack_Size这一段是 HardFault 的头号嫌疑犯。HAL 的不少函数在栈上开局部结构体，比如RCC_OscInitTypeDef就有十几个字段，一次配置就是几十字节；如果开了浮点运算、又没开 FPU 惰性压栈，中断现场保存还要多占。默认 1KB 在简单工程里够，一旦上了 RTOS 或者跑了递归解析，栈溢出会以“莫名其妙跑飞”的形式出现，很难反查。

向量表紧随其后，它必须放在 Flash 的最开头，因为 Cortex-M4 复位后从0x08000000取初始 SP、从0x08000004取Reset_Handler地址：

AREA RESET, DATA, READONLY EXPORT __Vectors __Vectors DCD __initial_sp ; 第 0 项：初始栈顶 DCD Reset_Handler ; 第 1 项：复位入口 DCD NMI_Handler DCD HardFault_Handler ; ... 中间是系统异常，后面是外设中断 DCD ADC1_2_IRQHandler DCD TIM1_UP_TIM16_IRQHandler

注意 F303 的中断名和 F1/F4 不完全一样，比如 ADC1 和 ADC2 共用ADC1_2_IRQHandler，TIM1_UP_TIM16是升级定时器和 16 位定时器共用的向量。中断函数名必须和这里逐字对应，改名后链接器不会报错，中断却永远不会进，这是新手最常卡住的地方。Reset_Handler里最终会调用SystemInit再跳__main，__main完成 RW/ZI 段初始化后才会进main()，所以main()里拿到的全局变量已经是零初始化过的。

2.3 分散加载：把 256KB Flash 和 40KB RAM 用对

Keil 的.sct文件决定了代码段和数据段落到的物理地址，基础工程里这份文件通常是这样：

LR_IROM1 0x08000000 0x00040000 { ER_IROM1 0x08000000 0x00040000 { *.o (RESET, +First) ; 向量表必须是第一个字节 *(InRoot$$Sections) .ANY (+RO) } RW_IRAM1 0x20000000 0x0000A000 { .ANY (+RW +ZI) } }

两个数字要对上芯片手册：0x00040000是 256KB，对应 F303CC 的 Flash 容量；0x0000A000是 40KB，对应 SRAM。F303 还有一块 8KB 的 CCM RAM 挂在0x10000000，它不参与 DMA 访问，但放栈或者高频访问的变量能省主 SRAM 带宽。基础工程默认不用 CCM，需要的时候在.sct里再加一个RW_IRAM2 0x10000000 0x00002000段，然后把变量用__attribute__((section(".ccmram")))丢进去。

*.o (RESET, +First)这一行是关键，它强制启动文件的目标文件排在镜像最前面。如果工程里手动调过链接顺序、或者加了自定义的段，向量表被挤走，程序上电直接 HardFault，现象是“下载成功、复位就挂”，查起来很费劲。

3. 最小系统代码：时钟、GPIO 与 SysTick 三件套

3.1 时钟树：72MHz 是这么一级级配出来的

F303 的上限主频是 72MHz，基础工程一般走 HSE 8MHz 晶振经 PLL 九倍频得到。这段代码在SystemClock_Config()里，是整份工程里最不该随手改、又最常被随手改的地方：

void SystemClock_Config(void) { RCC_OscInitTypeDef osc = {0}; RCC_ClkInitTypeDef clk = {0}; /* 第一级：选振荡源并配 PLL 输入输出 */ osc.OscillatorType = RCC_OSCILLATORTYPE_HSE; osc.HSEState = RCC_HSE_ON; osc.HSEPredivValue = RCC_HSE_PREDIV_DIV1; /* 8MHz 不分频 */ osc.PLL.PLLState = RCC_PLL_ON; osc.PLL.PLLSource = RCC_PLLSOURCE_HSE; osc.PLL.PLLMUL = RCC_PLL_MUL9; /* 8 * 9 = 72MHz */ if (HAL_RCC_OscConfig(&osc) != HAL_OK) { Error_Handler(); /* 卡在这里多半是晶振问题 */ } /* 第二级：把 PLL 输出分频到各条总线 */ clk.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2; clk.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; clk.AHBCLKDivider = RCC_SYSCLK_DIV1; /* HCLK = 72MHz */ clk.APB1CLKDivider = RCC_HCLK_DIV2; /* PCLK1 = 36MHz，上限就是 36 */ clk.APB2CLKDivider = RCC_HCLK_DIV1; /* PCLK2 = 72MHz */ if (HAL_RCC_ClockConfig(&clk, FLASH_LATENCY_2) != HAL_OK) { Error_Handler(); } }

三个参数要特别留意。HSEPredivValue是 F3 特有的预分频，如果板子焊的是 16MHz 晶振，要么改成RCC_HSE_PREDIV_DIV2再乘 9，要么直接调PLLMUL到 4.5——后者不存在，所以只能走预分频。APB1CLKDivider必须保证 PCLK1 不超过 36MHz，超了不是立刻挂，而是外设时序随机出问题，属于典型的“玄学 bug”。最后一个参数FLASH_LATENCY_2是 Flash 等待周期，72MHz 下必须给 2 个 WS，给少了代码从 Flash 取指会读到错数据。

还有一个容易被忽略的点：HAL_RCC_ClockConfig()内部会调用HAL_InitTick()重设 SysTick，并把SystemCoreClock更新成新的主频。如果你在它之前就用了HAL_Delay()，延时会是错的，因为那时SystemCoreClock还是默认的 8MHz。

3.2 GPIO 初始化：别把“点灯”写成不可复用的样子

基础工程里的 LED 驱动通常是这么写的，直接操作寄存器也行，走 HAL 也行，重点是参数和板子对得上：

/* bsp_led.h：把板级信息收在这一层，换板子只改这里 */ #define LED_PORT GPIOA #define LED_PIN GPIO_PIN_5 #define LED_CLK_EN() __HAL_RCC_GPIOA_CLK_ENABLE() void BSP_LED_Init(void) { GPIO_InitTypeDef gpio = {0}; LED_CLK_EN(); /* 时钟不开，后面写寄存器全是空操作 */ gpio.Pin = LED_PIN; gpio.Mode = GPIO_MODE_OUTPUT_PP; /* 推挽输出，驱动 LED 够用 */ gpio.Pull = GPIO_NOPULL; gpio.Speed = GPIO_SPEED_FREQ_LOW; /* 点灯不需要高速，低速噪声小 */ HAL_GPIO_Init(LED_PORT, &gpio); HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_SET); /* 上电默认熄灭 */ }

__HAL_RCC_GPIOA_CLK_ENABLE()这一行是所有 GPIO 问题的源头。F3 的 GPIO 时钟挂在 AHB 上，不开时钟去写GPIOA->ODR不会报错，也不会有任何反应，新手排查半天最后发现是漏了这一句。Speed参数在点灯场景无所谓，但如果这个引脚后面要输出 PWM 或者 SPI 时钟，低速档会导致边沿变缓、时序余量不够，我一般习惯在 BSP 层就直接给到GPIO_SPEED_FREQ_HIGH，省得后面改。

F3 还有一个和 F1 不一样的地方：模拟输入引脚必须显式配成GPIO_MODE_ANALOG，否则内部保护二极管和上下拉会影响采样精度。这一点在第 4 章 ADC 那节会再展开。

3.3 SysTick 与 HAL_Delay 的边界

SysTick 是 Cortex-M 内核自带的 24 位递减计数器，HAL 用它提供 1ms 心跳。HAL_Init()里会调用HAL_InitTick(TICK_INT_PRIORITY)，把重装载值设成SystemCoreClock / 1000，72MHz 下就是 72000。HAL_Delay(ms)本质是读uwTick全局变量做忙等：

/* HAL 库内部的实现，等价逻辑 */ __weak void HAL_Delay(uint32_t Delay) { uint32_t tickstart = HAL_GetTick(); uint32_t wait = Delay; if (wait < HAL_MAX_DELAY) wait += (uint32_t)(uwTickFreq); while ((HAL_GetTick() - tickstart) < wait) { } }

这段代码有一个隐性前提：uwTick必须在 SysTick 中断里递增。一旦你把 SysTick 的优先级设得比当前中断低，又在这个中断里调用HAL_Delay()，中断永远等不到uwTick变化，直接死锁。基础工程默认给 SysTick 的优先级是TICK_INT_PRIORITY = 0，也就是最高，属于保守做法；上了 RTOS 之后这个优先级通常要调低，那时候HAL_Delay就不能在中断上下文里用了。

真正做产品时我不会依赖HAL_Delay，而是自己开一个定时器做时基，或者干脆用状态机加HAL_GetTick()做非阻塞延时。基础工程里保留HAL_Delay是为了让新手有个能立刻看见效果的抓手，但它只适合调试阶段。

3.4 中断分组：一次设置，全局生效

HAL_Init()里有一句HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4)，把优先级分成 4 位抢占、0 位子优先级。这个设置是全芯片生效的，一旦后面某个外设初始化把它改成别的分组，之前配好的所有中断优先级解释方式全变，表现为中断响应顺序和你预期的不一致。

F303 的 NVIC 支持 4 位优先级，数值越小优先级越高。基础工程里给外设中断的默认配置一般是：

/* 以 USART2 为例，抢占优先级 1，子优先级 0 */ HAL_NVIC_SetPriority(USART2_IRQn, 1, 0); HAL_NVIC_EnableIRQ(USART2_IRQn);

两个参数在NVIC_PRIORITYGROUP_4下分别是抢占优先级和子优先级，子优先级实际上不起作用。我的习惯是在main.c开头把分组定死，后面所有外设统一按这个来，不在别处再调用HAL_NVIC_SetPriorityGrouping，这条规则写进团队规范比写在文档里管用。

4. 外设驱动挂载：CubeMX 分层与 F3 特色模拟外设

4.1 生成代码的分层与 USER CODE 保护区

如果你用图形化工具生成过初始化代码，一定见过这些成对出现的注释：

/* USER CODE BEGIN 2 */ BSP_LED_Init(); MX_USART2_UART_Init(); /* USER CODE END 2 */ while (1) { /* USER CODE BEGIN 3 */ HAL_GPIO_TogglePin(LED_PORT, LED_PIN); HAL_Delay(500); /* USER CODE END 3 */ }

USER CODE BEGIN/END之间的内容在重新生成时会被完整保留，之外的部分会被覆盖。血泪经验是：不要在这两个标记之外写任何一行自己的代码，哪怕只是加一个#include。真要在生成区加东西，把main.c里的函数拆到app_xxx.c里，main.c只留调用。基础工程如果已经带了 BSP 层，就更应该把业务逻辑全放到BSP和App目录，main.c保持成一张“接线图”。

生成代码的另一个分层是stm32f3xx_it.c，所有中断服务函数都落在这里，里面的HAL_XXX_IRQHandler(&hxxx)负责把中断转给 HAL 的回调。你要加自己的中断处理，正确姿势是重写HAL_XXX_Callback弱函数，而不是去改stm32f3xx_it.c，否则重新生成一次就没了。

4.2 ADC1 三通道扫描加 DMA：F3 最常用的采样姿势

F303 的 ADC 是这块片子的核心竞争力之一，12 位、最高 5MSPS，四路 ADC 里 ADC1/ADC2 还能配成双同步模式。基础工程里通常给一份单 ADC 多通道加 DMA 循环搬运的模板：

#define ADC_BUF_LEN 3 uint16_t adc_dma_buf[ADC_BUF_LEN]; /* 全局，DMA 直接写这里 */ static void MX_ADC1_Init(void) { ADC_ChannelConfTypeDef ch = {0}; hadc1.Instance = ADC1; hadc1.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV4; /* 72/4 = 18MHz */ hadc1.Init.Resolution = ADC_RESOLUTION_12B; hadc1.Init.ScanConvMode = ADC_SCAN_ENABLE; /* 多通道必须开 */ hadc1.Init.ContinuousConvMode = ENABLE; hadc1.Init.DiscontinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START; hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion = ADC_BUF_LEN; hadc1.Init.DMAContinuousRequests = ENABLE; /* 循环模式关键 */ hadc1.Init.EOCSelection = ADC_EOC_SEQ_CONV; /* 整组转换完才置 EOC */ HAL_ADC_Init(&hadc1); /* 三个通道依次入队，转换顺序就是这里的顺序 */ ch.Channel = ADC_CHANNEL_1; ch.Rank = ADC_REGULAR_RANK_1; ch.SamplingTime = ADC_SAMPLETIME_71CYCLES_5; HAL_ADC_ConfigChannel(&hadc1, &ch); /* CHANNEL_2 / CHANNEL_3 同理，Rank 依次 2、3 */ HAL_ADCEx_Calibration_Start(&hadc1, ADC_SINGLE_ENDED); /* F3 必须校准 */ HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_dma_buf, ADC_BUF_LEN); }

几个参数值得单独说。ClockPrescaler设成 PCLK/4 得到 18MHz 的 ADC 时钟，配合 71.5 个采样周期，单通道转换时间大约 1.4µs，对于电流采样这种场景余量充足；如果追求速度就降到 1.5 周期采样，但源阻抗高的时候精度会掉。DMAContinuousRequests = ENABLE让 DMA 在传输完成后自动重装，配合ContinuousConvMode形成“ADC 一直转、DMA 一直搬”的流水线，CPU 完全不参与，这也是 F3 做多路采样的标准写法。

HAL_ADCEx_Calibration_Start是 F3 特有的，上电后必须先跑一次校准，否则零点偏移能差几十个 LSB。校准前要保证 ADC 已经使能、时钟稳定，有些开发者把它放在HAL_ADC_Init之前，结果校准值全是 0，采样数据看着像噪声——这类问题我在第 5 章会再列一次。

4.3 OPAMP 与 COMP：F3 的模拟前端怎么起

F303 片内有 4 个运放和 7 个比较器，做小信号调理时能省掉外部器件。基础工程如果带了这部分，初始化顺序有讲究：先开SYSCFG时钟，再配 GPIO 为模拟模式，最后才初始化 OPAMP。

void BSP_OPAMP_Init(void) { __HAL_RCC_SYSCFG_CLK_ENABLE(); /* OPAMP 的配置寄存器挂在 SYSCFG 下 */ __HAL_RCC_OPAMP_CLK_ENABLE(); GPIO_InitTypeDef gpio = {0}; gpio.Pin = GPIO_PIN_1 | GPIO_PIN_2; /* OPAMP1 的 VINP 和 VOUT 复用脚 */ gpio.Mode = GPIO_MODE_ANALOG; /* 必须模拟模式，不能推挽 */ HAL_GPIO_Init(GPIOA, &gpio); hopamp1.Instance = OPAMP1; hopamp1.Init.PowerMode = OPAMP_POWERMODE_NORMAL; hopamp1.Init.Mode = OPAMP_PGA_MODE; hopamp1.Init.InvertingInput = OPAMP_INVERTINGINPUT_IO0; hopamp1.Init.NonInvertingInput = OPAMP_NONINVERTINGINPUT_IO0; hopamp1.Init.PgaGain = OPAMP_PGA_GAIN_4; HAL_OPAMP_Init(&hopamp1); HAL_OPAMP_Start(&hopamp1); }

SYSCFG时钟必须最先开，F3 的 OPAMP 和 COMP 配置位都挂在这个模块下，漏了这一句HAL_OPAMP_Init会返回错误但很多人不看返回值。PgaGain选 4 倍还是 2 倍取决于你的输入信号幅度，放大倍数越高带宽越低，做高频信号时要算一下 GBW。比较器同理，初始化后可以用HAL_COMP_Start()启动，输出既能走内部触发定时器，也能映射到 GPIO，做硬件过流保护很实用。

4.4 编译与下载：几个必须对齐的配置项

工程能编译不代表能跑。Keil 里三个配置项必须和芯片对齐：Device 选STM32F303CC，Flash Download 里的算法选STM32F3xx 256KB Flash，Debug 里选的下载器要和实际接的探针对上。第三个最容易翻车，尤其换电脑之后 SWD 时钟被设得太高，接上就报 “Cannot access target”。

命令行构建的话，基础工程通常同时提供一份 Makefile，把arm-none-eabi-gcc的编译、链接、objcopy生成 bin 串起来：

make clean && make -j8 # 全量编译 make flash # 依赖 openocd 或 pyocd 下载 arm-none-eabi-size build/F303_Base.elf # 看 code/data/bss 占用

size这条命令建议每次编译后都扫一眼，text段接近 Flash 容量的 80% 时就该考虑裁剪 HAL 模块了。data + bss之和接近 40KB 的时候，检查一下是不是哪个大数组忘了加const丢到了 RAM 里。

5. 避坑与排查：基础工程里翻车率最高的五个地方

5.1 下载成功但一复位就进 HardFault

现象：IDE 里点下载显示成功，点复位后程序不跑，调试器停在HardFault_Handler的while(1)里。

原因：向量表没有落在0x08000000，或者启动文件选的型号和芯片容量不匹配。.sct里少了*.o (RESET, +First)、或者工程是从别的型号移植过来没改启动文件，都会让复位向量读到错误地址。

解决：先用调试器看0x08000000处的四个字节是不是一个合理的栈顶值（0x2000xxxx），再看0x08000004处的值是不是落在 Flash 范围内。不一致就回头检查.sct和startup_stm32f303xc.s有没有被正确加入工程。

5.2 卡在 HAL_RCC_OscConfig 里出不来

现象：单步调试停在SystemClock_Config()的Error_Handler()，或者程序根本没走到main()的while(1)。

原因：HSE 起振失败。板子上没焊晶振、焊的是 16MHz 而代码按 8MHz 配、负载电容不匹配，三种情况都会导致HAL_RCC_OscConfig返回HAL_ERROR。

解决：先确认板上晶振频率，改HSE_VALUE宏和HSEPredivValue。临时验证可以先把时钟源切成 HSI，用内部 8MHz RC 经 PLL 倍频到 64MHz，能跑起来就说明是外部晶振的问题。量产板还要看起振时间，RCC_OscInitTypeDef里没有直接的起振超时参数，HAL 内部用的是固定超时，晶振质量差的时候偶发启动失败，这个只能换器件。

5.3 HAL_Delay 卡死或者延时明显偏长

现象：主循环里调HAL_Delay(500)，实际等了三四秒，或者干脆卡住不动。

原因有三种：SysTick 中断被关掉了；SystemCoreClock没有跟着实际主频更新，导致重装载值算错；在高于 SysTick 优先级的中断里调用了HAL_Delay。

解决：在main()里打印SystemCoreClock确认是 72000000。检查有没有在别处调用__disable_irq()之后忘了开。中断里不要用HAL_Delay，要延时就记时间戳在主循环里判断。

5.4 ADC 采样值抖动大、通道之间串扰

现象：接一个稳定电压源，读出来的值上下跳几十个码，或者三个通道的数据看起来互相污染。

原因：GPIO 没配成GPIO_MODE_ANALOG，内部上下拉和 Schutz 二极管在分压；采样时间太短，源阻抗高的信号没充够采样电容；DMA 缓冲区被其他代码改写。

解决：逐个通道确认 GPIO 模式，用万用表量一下实际电压和读数的对应关系。采样时间从 1.5 周期加到 71.5 周期试一下，如果抖动明显变小就是源阻抗问题，必要时在外部加一级跟随。DMA 缓冲区加__IO或者用volatile声明，避免编译器优化把它优化掉。

5.5 重新生成代码后自己的逻辑全没了

现象：用图形化工具改了个引脚配置，重新生成之后main.c里的业务代码消失，编译报一堆未定义。

原因：代码写在了USER CODE BEGIN/END标记之外。生成工具只保护标记内的内容，标记外的任何改动都会被覆盖。

解决：养成“只往标记里写”的习惯，复杂逻辑一律拆到独立文件。如果已经被覆盖，先看看工程目录下有没有backup文件夹，生成工具一般会留一份上一次的备份，能捞回来一部分。捞不回来就只能从 Git 里翻了，这也是为什么基础工程进版本库时要连.ioc一起提交。

6. 二次开发：把基础工程改成自己的模板

基础工程最大的价值不在“能跑”，而在“能改”。我一般会做三件事把它变成团队模板。

第一件是把 BSP 层拆细。bsp_led、bsp_uart、bsp_adc各自一对.c/.h，头文件里只暴露Init和业务语义接口（比如BSP_LED_Toggle()），把 HAL 的结构体全部藏在.c里。这样业务层不依赖 HAL，将来换芯片只改 BSP 实现。

第二件是加一层app_config.h，用宏把可选功能开关掉：

/* app_config.h：编译期裁剪，注释掉就彻底不进镜像 */ #define APP_USE_UART_LOG 1 #define APP_USE_ADC_SAMPLE 1 #define APP_USE_OPAMP 0

配合stm32f3xx_hal_conf.h里的模块开关一起用，能做到“关掉的功能一行代码都不进 Flash”。F303CC 的 256KB 看着宽裕，真把 HAL 全量编进去再加上浮点库，占用能到一半以上。

第三件是准备两个构建入口。Keil 工程给不熟悉命令行的同事用，Makefile 给 CI 用，两边共用同一份源文件和同一个.sct/.ld，保证产物一致。CI 里跑一遍arm-none-eabi-size，把text和bss的数字设个阈值，超了就报警，比人工看靠谱。

改造完一定要做一次“空板验证”：拿一块焊好的新板子，只烧这份模板，确认 LED 会闪、串口能打印SystemCoreClock、ADC 读到的值在合理范围。这三项过了，才说明模板本身是干净的。从那以后我每次换芯片型号，都会先跑一遍这个空板验证，再往里加业务代码——血泪经验是，把板子问题和代码问题混在一起查，一晚上就没了。希望这套骨架能帮你少走那段弯路。

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