1. 项目概述：为什么需要一个“一步到位”的工程模板？

如果你刚开始接触STM32，或者刚从标准库（Standard Peripheral Library）转向HAL库（Hardware Abstraction Layer），那么新建一个工程绝对是第一个让你头疼的坎。网上教程五花八门，有的让你手动复制文件，有的依赖CubeMX生成但没讲清楚后续怎么改，还有的教程里提到的库版本可能早就过时了，你照着做，编译时却蹦出一堆“头文件找不到”、“未定义的引用”之类的错误。这种感觉就像给你一堆乐高零件，却没给说明书，让你自己拼出一辆能跑的汽车。

这个名为“【一步到位】”的STM32 HAL库工程模板项目，就是为了彻底解决这个痛点。它的核心目标不是教你点几下CubeMX，而是帮你建立一个干净、规范、可移植、且完全在自己掌控之下的工程起点。这个模板包含了HAL库、CMSIS核心文件、必要的启动文件、链接脚本，以及一个预先配置好的、结构清晰的用户代码目录。你拿到手后，只需要修改芯片型号（如果需要），然后就可以直接在上面写你的应用代码，比如点灯、读串口、操作ADC，而不用再操心底层文件是否齐全、路径是否正确。

为什么强调“一步到位”？因为对于项目开发，尤其是团队协作，一个统一的工程结构至关重要。它能避免“在我的电脑上能编译，在你的电脑上就报错”的尴尬，也能让你在开发新功能时，快速将精力集中在业务逻辑上，而不是反复搭建环境。这个模板基于当前（以撰写时为准）主流的开发环境Keil MDK（即Keil uVision5）和STM32Cube固件包，确保其时效性和可用性。接下来，我将带你从零开始，不仅“得到”这个模板，更要彻底理解它里面的每一部分为什么存在，以及如何根据你的芯片进行微调，真正做到知其然，更知其所以然。

2. 工程模板的整体设计与核心思路

2.1 为什么选择HAL库而非标准库或LL库？

在搭建模板前，首先要明确库的选择。STM32的软件开发主要有三种方式：标准外设库（SPL）、硬件抽象层库（HAL）和底层库（LL）。

• 标准外设库（SPL）：这是STM32早期的官方库，直接操作寄存器，效率高，但代码繁琐，移植性差，且ST已停止更新，对新芯片支持不足。不推荐新项目使用。
• 硬件抽象层库（HAL）：ST目前主推的库。它通过封装硬件细节，提供了统一的API接口。最大的优点是可移植性极强，为同一外设（如UART、I2C）编写的代码，在不同系列的STM32芯片间几乎可以无缝迁移。它提供了完善的中间件（如USB、文件系统、网络协议栈）支持，并且与STM32CubeMX工具深度集成，可以图形化配置并生成初始化代码。缺点是代码量稍大，执行效率比直接操作寄存器低一些，但对于绝大多数应用，这点开销完全可以接受。
• 底层库（LL）：可以看作是HAL库的“轻量级”补充，它更接近寄存器操作，效率高，但同样保持了较好的可读性。通常与HAL库混合使用，在对性能要求苛刻的局部代码中使用LL。

我们的选择是HAL库。对于新建工程模板，可移植性和开发效率是首要考虑因素。HAL库能让我们快速上手，并且当未来项目需要更换芯片（比如从F1系列换到F4系列）时，我们的应用层代码需要改动的地方会少很多。这个模板也将围绕HAL库来构建。

2.2 工程目录结构设计：清晰与隔离

一个混乱的工程目录是后期维护的噩梦。我们的模板采用一种经典且清晰的分层结构，核心思想是将芯片厂商提供的库文件、中间件与我们自己编写的应用代码严格分离。

MyStm32Project/ ├── Core/ │ ├── Inc/ // 用户头文件，如 main.h, gpio.h, usart.h │ ├── Src/ // 用户源文件，如 main.c, gpio.c, usart.c │ ├── Startup/ // 芯片启动文件（.s文件） │ └── stm32f1xx_it.c // 中断服务函数文件（根据芯片系列） ├── Drivers/ │ ├── CMSIS/ // ARM Cortex-M核心支持文件 │ └── STM32F1xx_HAL_Driver/ │ ├── Inc/ // HAL库头文件 │ └── Src/ // HAL库源文件 ├── MDK-ARM/ // Keil工程文件（.uvprojx）及输出文件（.axf, .hex） ├── README.md // 项目说明文档 └── .gitignore // Git版本控制忽略文件

这样设计的好处：

1. 核心应用代码集中：所有你写的代码都在Core/Inc和Core/Src里，一目了然。
2. 驱动库独立且完整：Drivers目录包含了所有依赖的底层库，你可以整体替换HAL库版本，而不会影响你的代码。
3. 工程文件隔离：Keil的工程文件放在MDK-ARM，编译生成的中间文件、列表文件、可执行文件也都在这里，不会污染源代码目录。
4. 易于版本管理：你可以方便地将Core和Drivers目录纳入Git管理，而忽略MDK-ARM里那些频繁变化的中间文件。

2.3 工具链选型：Keil MDK的利与弊

我们选择Keil MDK（Microcontroller Development Kit）作为默认的集成开发环境（IDE）。

• 优势：在STM32开发领域占有率极高，资料丰富，生态完善。其编译器（ARMCC/ARMCLANG）优化效果好，调试器（配合ST-Link、J-Link）功能强大、稳定。对于初学者和大多数商业项目，它是一个可靠的选择。
• 需要注意的：Keil是商业软件，需要购买许可证或使用有代码大小限制的评估版。网络上流传的“注册机”存在法律和安全风险，强烈建议个人学习者使用官方提供的免费评估版（代码大小限制为32KB），企业应购买正版授权。

注意：本模板的构建方法同样适用于其他IDE（如IAR、STM32CubeIDE、VSCode+GCC Arm），核心的目录结构和文件组织思想是通用的。在Keil中搭建成功后，你可以更容易地理解工程所需的文件，从而迁移到其他平台。

3. 核心文件解析与获取途径

3.1 基石：CMSIS与启动文件

CMSIS（Cortex Microcontroller Software Interface Standard）是ARM公司制定的一套 Cortex-M 处理器硬件抽象层标准。它定义了访问内核寄存器、外设的通用接口，确保了不同芯片厂商的软件兼容性。我们的模板必须包含它。

关键CMSIS文件：

• core_cm3.c/h(或cm4,cm7等)：提供访问Cortex-M内核寄存器的内联函数和定义。
• system_stm32f1xx.c/h：包含系统初始化函数SystemInit()（配置时钟树）和系统时钟频率变量SystemCoreClock。
• stm32f1xx.h：这是最重要的芯片头文件，它包含了特定STM32系列（如F1）的所有外设寄存器定义、内存映射和中断编号。它通过#define来选择具体的芯片型号（例如STM32F103xC）。

启动文件（Startup File）：这是一个用汇编语言（.s后缀）编写的文件，例如startup_stm32f103xe.s。它是芯片上电后运行的第一段代码，负责：

1. 初始化堆栈指针（SP）。
2. 设置程序计数器（PC）指向复位中断服务程序。
3. 调用SystemInit()函数初始化系统时钟。
4. 将初始化数据从Flash拷贝到RAM（初始化全局变量）。
5. 调用C语言的main()函数。不同芯片型号、不同编译器的启动文件都不一样，必须严格匹配。

3.2 核心驱动：STM32Cube HAL固件包

这是ST官方提供的、包含HAL库、LL库以及各种中间件的软件包。我们需要从中提取HAL库文件。

如何获取？

1. 通过STM32CubeMX软件：安装CubeMX时，它会提示你下载或在线安装固件包。安装后，固件包通常位于C:\Users\[用户名]\STM32Cube\Repository\STM32Cube_FW_F1_Vx.x.x（以F1系列为例）。
2. 从ST官网直接下载：访问ST官网的对应产品页面，在“工具与软件”->“嵌入式软件”->“STM32Cube MCU包”中下载。

我们需要提取的内容（以STM32F1系列为例）：

• Drivers/STM32F1xx_HAL_Driver/Inc和Src：整个HAL库的源码头文件。
• Drivers/CMSIS/Device/ST/STM32F1xx/：包含芯片相关的CMSIS文件（stm32f1xx.h,system_stm32f1xx.c,Include/下的头文件）以及启动文件（Source/Templates/arm/下的.s文件）。
• Projects/目录下通常有各种开发板的示例工程，可以作为参考，但我们不直接使用，而是自己构建。

3.3 用户代码骨架：main.c与中断处理

模板中的用户代码部分需要提供一个干净的起点。

• main.c：包含main()函数。一个良好的HAL库工程main函数结构如下：

  #include "main.h" #include "stm32f1xx_hal.h" // 主HAL头文件 int main(void) { HAL_Init(); // 初始化HAL库，配置SysTick定时器、NVIC优先级分组 SystemClock_Config(); // 系统时钟配置函数（需自己实现或由CubeMX生成） MX_GPIO_Init(); // 外设初始化函数（需自己实现或由CubeMX生成） // ... 其他初始化 while (1) { // 用户主循环 } }

• stm32f1xx_it.c/h：集中存放所有中断服务函数（IRQ Handler）。HAL库为每个外设的中断都提供了弱定义（__weak）的默认处理函数（通常是空函数或错误处理函数）。当发生中断时，会先调用HAL库的中断处理函数（如HAL_UART_IRQHandler），然后可能会调用你重写的回调函数（Callback）。我们需要这个文件来重写那些我们需要自定义的中断服务函数，例如SysTick_Handler（HAL库用其做时基）和USART1_IRQHandler等。

4. 手把手构建“一步到位”工程模板

4.1 准备工作：安装环境与获取资源

1. 安装Keil MDK：从ARM官网下载并安装Keil MDK-ARM。安装过程中会提示安装设备支持包（Device Family Pack，DFP），请务必选择你使用的STM32系列（如STM32F1xx）。
2. 安装STM32CubeMX：从ST官网下载安装。这是一个图形化配置工具，虽然我们不直接用它生成完整工程，但可以用它来验证时钟配置和生成初始化代码片段，非常有用。
3. 下载HAL固件包：如前所述，通过CubeMX或官网下载对应你芯片系列的Cube固件包（如STM32Cube_FW_F1_V1.8.4）。

4.2 步骤一：创建工程目录与文件结构

在你的工作区（例如D:\Projects\）新建一个文件夹，命名为你的工程名，如MyStm32Template。然后按照前面设计的目录结构，手动创建所有子文件夹（Core/Inc,Core/Src,Core/Startup,Drivers/CMSIS,Drivers/STM32F1xx_HAL_Driver等）。这一步虽然繁琐，但能让你对工程结构有最深刻的理解。

4.3 步骤二：填充驱动库文件

从下载的Cube固件包中，将文件复制到对应目录：

1. 将STM32Cube_FW_F1_V1.8.4\Drivers\STM32F1xx_HAL_Driver\下的Inc和Src文件夹，整个复制到你的Drivers/STM32F1xx_HAL_Driver/下。
2. 将STM32Cube_FW_F1_V1.8.4\Drivers\CMSIS\Device\ST\STM32F1xx\Include\下的所有头文件（.h），复制到你的Drivers/CMSIS/下（你可以新建一个Include子文件夹来存放，或者直接放进去，只要后续在Keil中包含路径正确即可）。
3. 将STM32Cube_FW_FW_F1_V1.8.4\Drivers\CMSIS\Device\ST\STM32F1xx\Source\Templates\arm\下与你芯片和编译器对应的启动文件（对于Keil MDK，通常是startup_stm32f103xe.s，具体名字取决于你的芯片Flash大小）复制到你的Core/Startup/下。
4. 将STM32Cube_FW_F1_V1.8.4\Drivers\CMSIS\Device\ST\STM32F1xx\Source\Templates\下的system_stm32f1xx.c复制到你的Drivers/CMSIS/下。
5. 将STM32Cube_FW_F1_V1.8.4\Drivers\CMSIS\Device\ST\STM32F1xx\Include\下的stm32f1xx.h和system_stm32f1xx.h也复制到Drivers/CMSIS/下。

实操心得：第一次手动复制可能会觉得麻烦，但这能让你清楚每一个文件的来源和作用。之后你可以将这个整理好的Drivers文件夹存档，作为以后所有F1系列项目的“驱动库快照”，无需每次都从Cube包中提取。

4.4 步骤三：创建用户代码与Keil工程

1. 创建基础用户文件：

   • 在Core/Inc下创建main.h。
   • 在Core/Src下创建main.c和stm32f1xx_it.c。
   • 在Core/Inc下创建stm32f1xx_it.h。
   • 从Cube固件包的示例工程里（如Projects\STM3210C_EVAL\Examples\GPIO\GPIO_IOToggle）找一个main.c和stm32f1xx_it.c作为参考，拷贝其基本框架（包含必要的头文件、HAL_Init、主循环等），但删除所有具体的应用代码，只保留骨架和必要的注释。同样参考示例编写.h文件。

2. 在Keil中创建新工程：

   • 打开Keil uVision5，点击Project -> New uVision Project...。
   • 浏览到你的工程根目录MyStm32Template，建议在根目录下创建一个Project或MDK-ARM文件夹来存放工程文件，这里我们选择MDK-ARM文件夹，然后为工程命名（如MyTemplate）。
   • 在弹出的“Select Device for Target”窗口中，选择你的具体STM32芯片型号（例如STMicroelectronics -> STM32F103 Series -> STM32F103ZE）。这一步非常重要，它决定了Keil会关联哪些调试信息、内存映射和默认的宏定义。

3. 管理工程中的文件组（Project Groups）： Keil工程左侧的“Project”窗口，默认有一个Source Group 1。我们需要建立清晰的文件组来对应我们的目录结构。

   • 右键点击Target 1，选择Manage Project Items...。
   • 在Project Items标签页，你可以重命名Target 1为你的芯片名，如STM32F103ZE。
   • 在Groups区域，删除默认的Source Group 1，然后新建以下组：
     • Startup：用于存放启动文件。点击Add Files，选择Core/Startup/startup_stm32f103xe.s。
     • User：用于存放用户代码。添加Core/Src/main.c和Core/Src/stm32f1xx_it.c。
     • HAL_Driver：用于存放HAL库源文件。注意：不要一次性添加所有.c文件，那样编译极慢且工程臃肿。只添加你当前项目用到的外设对应的.c文件。例如，一个最简单的点灯工程，可能只需要stm32f1xx_hal.c,stm32f1xx_hal_gpio.c,stm32f1xx_hal_rcc.c（时钟控制）。你可以后续根据需要添加。
     • CMSIS：添加Drivers/CMSIS/system_stm32f1xx.c。

4.5 步骤四：配置关键工程选项（Options for Target）

这是构建模板中最关键、最容易出错的一步。右键点击工程目标（STM32F103ZE），选择Options for Target...。

1. Target 标签页：

   • Xtal (MHz)：输入你外部晶振的频率，通常是8.0。
   • 确认ARM Compiler版本，一般用默认的Use default compiler version 5或6即可。

2. Output 标签页：

   • 选择Select Folder for Objects...，将输出目录指向MDK-ARM/Objects，保持工程整洁。
   • 勾选Create HEX File，方便烧录。

3. C/C++ 标签页（重中之重）：

   • Define：在这里定义全局宏。必须包含：USE_HAL_DRIVER（告诉代码我们要使用HAL库）。STM32F103xE（这个宏必须与你的芯片型号匹配，并在stm32f1xx.h中被定义，用于选择正确的芯片型号和内存映射）。多个宏用英文逗号隔开。

     USE_HAL_DRIVER,STM32F103xE

   • Include Paths：添加所有头文件所在的目录。这是解决“include error”的关键。点击末尾的...按钮，添加以下路径（根据你的实际目录调整）：
     • ../Core/Inc
     • ../Drivers/STM32F1xx_HAL_Driver/Inc
     • ../Drivers/CMSIS(或../Drivers/CMSIS/Include，如果你把CMSIS头文件放在了子文件夹里)
     • ../Drivers/CMSIS/Device/ST/STM32F1xx/Include(如果你按照Cube包原始结构放置了芯片特定头文件)

4. Debug 标签页：

   • 选择你使用的调试器，如ST-Link Debugger。
   • 点击Settings，在Debug子标签页确认Port为SW（Serial Wire）。在Flash Download子标签页，点击Add，选择你的芯片对应的Flash编程算法（如STM32F10x High-density Flash）。如果没有正确添加，将无法下载程序。

5. Utilities 标签页：

   • 取消勾选Use Debug Driver（如果已勾选）。
   • 在Settings中，同样配置Flash Download标签页，添加Flash编程算法。

4.6 步骤五：编写系统时钟配置函数

一个能运行的程序必须有正确的时钟。你可以从CubeMX生成的代码中，或者从Cube固件包的示例工程里，找到SystemClock_Config()函数的实现，将其复制到你的main.c中。这个函数内部会调用HAL_RCC_OscConfig()和HAL_RCC_ClockConfig()来配置HSE（外部高速时钟）、PLL（锁相环）和系统时钟（SYSCLK）。对于STM32F103ZE，一个常见的72MHz系统时钟配置如下：

void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; // 初始化HSE，配置PLL RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9; if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) { Error_Handler(); } // 配置系统时钟源、AHB、APB1、APB2分频器 RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK) { Error_Handler(); } }

同时，需要在main.h中声明这个函数：void SystemClock_Config(void);。

4.7 步骤六：编译与下载测试

1. 点击Build（F7）按钮编译工程。如果前面所有步骤都正确，你应该能获得0 Error(s), 0 Warning(s)的编译结果。
2. 连接好你的STM32开发板和ST-Link调试器。
3. 点击Load（F8）按钮下载程序到芯片。
4. 此时程序应该已经运行。为了验证，你可以在main函数的while(1)循环里添加一个简单的LED闪烁代码（假设LED连接在PC13）：

   // 在main()的初始化部分之后 __HAL_RCC_GPIOC_CLK_ENABLE(); // 使能GPIOC时钟 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_13; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOC, &GPIO_InitStruct); while (1) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); HAL_Delay(500); // 使用HAL_Delay，它依赖于SysTick中断 }

5. 重新编译、下载，观察开发板上的LED是否开始闪烁。如果成功，恭喜你，一个“一步到位”的、完全由自己掌控的HAL库工程模板就搭建成功了！

5. 常见问题与深度排查指南

即使按照步骤操作，也难免会遇到问题。这里汇总了新建HAL库工程时最常见的“坑”及其解决方案。

5.1 编译错误：头文件找不到（Include Error）

这是最常见的问题，Keil会提示fatal error: ‘stm32f1xx.h‘ file not found或类似信息。

• 原因1：包含路径（Include Paths）未正确设置。

  • 排查：再次检查Options for Target -> C/C++ -> Include Paths。确保路径是相对于工程文件（.uvprojx）所在目录的相对路径。使用../来向上级目录导航。确保路径指向了包含所需头文件的文件夹。
  • 技巧：在Keil中，你可以右键点击一个#include出错的行，选择Open document “xxx.h”，如果打不开，就说明路径不对。如果能打开，弹出的对话框会显示这个头文件的实际路径，你可以对照检查你的包含路径是否覆盖了该路径的父目录。

• 原因2：全局宏（Define）未定义或定义错误。

  • 排查：检查Options for Target -> C/C++ -> Define。必须包含USE_HAL_DRIVER和正确的芯片型号宏（如STM32F103xE）。这个芯片型号宏必须与stm32f1xx.h文件里#if defined的某个分支完全匹配。打开stm32f1xx.h文件，搜索“#if defined(STM32F103xE)”来确认。

• 原因3：文件确实不存在。

  • 排查：去你复制文件的目录下，确认stm32f1xx.h等文件是否真的存在。有时复制可能会遗漏。

5.2 链接错误：未定义的符号（Undefined Symbol）

编译通过，但链接时出错，提示某个函数找不到，比如undefined symbol HAL_Init。

• 原因1：对应的HAL库源文件（.c）没有添加到工程中。

  • 排查：例如，错误提到HAL_Init，这个函数在stm32f1xx_hal.c中。检查你的HAL_Driver文件组里是否添加了stm32f1xx_hal.c文件。
  • 解决：根据错误信息，将缺失的.c文件添加到工程中。记住一个原则：用到哪个外设，就添加哪个外设的.c文件。例如，用了GPIO，就加stm32f1xx_hal_gpio.c；用了UART，就加stm32f1xx_hal_uart.c。stm32f1xx_hal.c（HAL核心）和stm32f1xx_hal_rcc.c（时钟控制）几乎是必加的。

• 原因2：启动文件选错。

  • 排查：链接错误也可能指向一些奇怪的汇编符号。检查Core/Startup下的启动文件是否与你的芯片型号完全匹配。例如，STM32F103C8T6（中容量）应该用startup_stm32f103xb.s，而STM32F103ZET6（高容量）用startup_stm32f103xe.s。文件名中的xb、xe等后缀对应芯片的Flash容量类别。

5.3 程序下载失败

• 原因1：Flash编程算法未添加或选错。

  • 排查：检查Options for Target -> Debug -> Settings -> Flash Download和Utilities -> Settings -> Flash Download，确保已经添加了对应你芯片Flash大小的正确算法。例如，STM32F103ZE（512KB Flash）属于“高密度”产品，应选择STM32F10x High-density Flash。

• 原因2：调试器连接或配置问题。

  • 排查：确认ST-Link等调试器驱动已安装，连接线可靠。在Debug设置中，确认Port设置为SW，速度可以尝试调低（如1MHz）。检查芯片供电是否正常。

• 原因3：芯片处于写保护状态或选项字节（Option Bytes）配置有误。

  • 排查：有时误操作可能锁定了芯片。可以使用ST官方的STM32 ST-LINK Utility或STM32CubeProgrammer工具连接芯片，尝试进行“全片擦除”（Full Chip Erase）来解除保护。

5.4 程序运行异常（如LED不闪）

• 原因1：系统时钟未正确配置。

  • 排查：SystemClock_Config()函数是否被正确调用？时钟配置参数（如PLL倍数、分频系数）是否与你的外部晶振频率匹配？可以使用HAL_RCC_GetSysClockFreq()函数在调试时打印或查看系统时钟频率。
  • 技巧：强烈建议使用STM32CubeMX来生成初始化的时钟配置代码。在CubeMX中选好芯片，在Clock Configuration标签页图形化配置时钟树，然后生成代码，将main.c中的SystemClock_Config()函数复制过来即可，可以避免手动计算分频系数的错误。

• 原因2：外设时钟未使能。

  • 排查：在操作任何外设（GPIO、USART等）之前，必须首先使能其时钟。例如，操作GPIOC，必须调用__HAL_RCC_GPIOC_CLK_ENABLE()。这是HAL库操作外设的铁律。

• 原因3：SysTick中断未正常工作，导致HAL_Delay()失效。

  • 排查：HAL_Init()函数会初始化SysTick定时器。如果程序卡在HAL_Delay()，可能是SysTick中断未触发。检查stm32f1xx_it.c中是否有SysTick_Handler函数，并且它是否调用了HAL_IncTick()。这个函数通常由HAL库的弱定义提供，一般不需要修改，但必须存在。

5.5 工程移植与维护技巧

• 更换芯片型号：如果要为另一款芯片（如STM32F407）搭建模板，核心工作是：

  1. 更新Drivers目录下的HAL库和CMSIS文件（从F4的Cube包获取）。
  2. 更换启动文件。
  3. 在Keil工程选项中，更改Device，并更新Define中的芯片型号宏（如改为STM32F407xx）。
  4. 更新SystemClock_Config()函数（用CubeMX为F4生成一个）。
  5. 根据新芯片的参考手册，调整外设初始化代码（如GPIO、USART的引脚复用功能可能不同）。

• 管理HAL库版本：将Drivers目录整体备份。当ST发布新的Cube固件包时，你可以将新的Drivers替换旧的，然后重新编译工程。由于HAL库API保持向后兼容，通常只需解决一些编译警告即可。这是一种清晰、安全的库管理方式。

• 使用CubeMX生成初始化代码，然后整合到模板：这是最高效的工作流。在CubeMX中配置好引脚、时钟、外设参数，生成代码。然后只将其生成的main.c中的初始化函数（MX_GPIO_Init,MX_USART1_UART_Init等）和SystemClock_Config()函数复制到你模板工程的main.c中；将其生成的stm32f1xx_it.c中的中断函数复制到你的文件中；将其生成的Inc/目录下的头文件内容整合到你的头文件中。不要直接使用CubeMX生成的整个工程目录，那样你会失去对工程结构的控制，又回到了起点。我们的模板是“骨架”，CubeMX生成的是“肌肉”，二者结合，既规范又高效。