keil5新建工程这件事，看起来就是点几下 Project -> New uVision Project，但真正踩过坑的人都知道，它牵扯的东西远比“新建”两个字复杂：芯片包有没有装、启动文件选得对不对、标准库还是 HAL、宏定义写没写、头文件路径加没加、下载算法匹配不匹配，任何一环出问题，都会表现成“新建不了工程”“找不到芯片”“编译0错误却下载失败”。我刚从 C51 转到 STM32 那会儿，最怕的就是新建工程，因为别人的工程能跑，自己照猫画虎建一个就各种红叉。后来带新人、做项目、维护老代码，才发现 Keil5 新建工程其实是嵌入式开发里最值得一次性搞明白的基本功。它解决的不是“怎么点菜单”，而是把芯片、库、编译链、调试器、下载算法这几件事绑成一个可维护的工程骨架。下面我按真实操作顺序，把 STM32 标准库新建工程、CubeMX 生成 Keil5 工程、常见报错排查和模板复用经验一次讲透，适合刚装好 Keil5 的新手，也适合想把工程结构重新梳理一遍的老手。
1. 先把环境与工程边界定清楚
1.1 Keil5到底新建的是什么工程
很多人以为 Keil5 新建工程就是把代码文件堆进去，其实不对。Keil MDK 的 uVision 只是一个集成开发环境，它负责组织文件组、调用编译器、链接器、调试器和下载算法。你点下 New uVision Project 之后，生成的核心文件是.uvprojx和.uvoptx，前者记录目标芯片、文件组、宏定义、头文件路径、优化等级、下载算法，后者记录窗口布局、断点、调试器选择等个人偏好。也就是说，新建工程真正做的是建立一套“编译和下载的配置关系”，而不是自动帮你复制标准库或 HAL 库。标准库工程需要你手动把 CMSIS、StdPeriph_Driver、启动文件、用户代码放进目录，再在 Keil 里告诉它去哪找头文件、编译哪些.c、链接哪个启动文件。CubeMX 工程则是 CubeMX 帮你生成这些库文件和 MDK 工程文件，Keil5 只负责打开和编译。理解这一点后，你就不会在 Manage Run-Time Environment 里乱勾，也不会疑惑为什么工程建完是空的。
1.2 芯片包、授权与目录规划
Keil5 新建工程时弹出的 Select Device 列表，并不是 Keil 自带所有芯片，而是来自 Device Family Pack，也就是常说的 DFP 芯片包。装完 Keil MDK 后，第一件事应该是打开 Pack Installer，搜索 STM32F1、STM32F4 等你需要的系列，把对应 DFP 装好。如果列表里没有 STM32F103C8，不是软件坏了，而是芯片包没装或者版本不匹配。授权方面建议按官方渠道处理，评估版、社区版或正版授权都行，不要用来路不明的补丁，否则后面编译、下载、Pack 更新都可能出奇怪问题。目录规划更关键：工程路径不要放桌面，不要有中文、空格和特殊符号，最好用类似D:\MCU\STM32F103\StdPeriph_Template这种短路径。C 盘 Program Files 下面权限复杂，Keil 生成中间文件时可能失败。每个工程单独一个文件夹，里面再分User、CMSIS、FWlib、Project、Obj、List，以后复制模板、备份、清空编译产物都方便。
1.3 标准库、HAL、CubeMX三条路线怎么选
新建工程之前要先选路线，路线选错，后面越建越乱。标准库适合 STM32F1/F4 老项目、教学和需要看清寄存器操作的人，代码直观，资料多，但新芯片支持差。HAL 库加 CubeMX 适合快速开发、跨系列移植、使用新芯片的人，图形化配置时钟和外设很省事，但抽象层厚，出问题要会看 HAL 源码。寄存器路线适合对底层极熟、资源极紧的场景，新手不建议一上来就硬啃。我的建议是：如果你手头是 STM32F103C8T6 这类经典芯片，先用标准库手动建一次工程，把启动文件、宏定义、头文件路径、下载算法走一遍；等这套流程熟了，再用 CubeMX 生成一个 HAL 工程对比。这样你既知道 Keil5 工程底层怎么组织，又能享受 CubeMX 的效率。两条路线不要混在同一个工程里，标准库和 HAL 同时编译，符号冲突和中断向量问题会让人非常难受。
2. Keil5新建STM32标准库工程：从空白文件夹到能编译
2.1 手工搭建目录骨架
我习惯先建目录再开 Keil，因为 Keil 的 Add Files 是往工程里加引用，不是复制文件。以 STM32F103C8T6 为例，先准备一个标准库模板目录，结构可以是这样：
StdPeriph_Template ├─ CMSIS │ ├─ core_cm3.h │ ├─ stm32f10x.h │ ├─ system_stm32f10x.c │ ├─ system_stm32f10x.h │ └─ startup_stm32f10x_md.s ├─ FWlib │ ├─ inc │ │ ├─ stm32f10x_gpio.h │ │ ├─ stm32f10x_rcc.h │ │ └─ 其他外设头文件 │ └─ src │ ├─ stm32f10x_gpio.c │ ├─ stm32f10x_rcc.c │ └─ 其他外设源文件 ├─ User │ ├─ main.c │ ├─ stm32f10x_conf.h │ ├─ stm32f10x_it.c │ ─ stm32f10x_it.h ─ Project这个结构不是唯一答案，但它把芯片相关、库相关、用户相关、工程相关分开了。启动文件必须和芯片容量匹配，STM32F103C8T6 有 64KB Flash、20KB RAM，属于中容量，启动文件选startup_stm32f10x_md.s，宏定义选STM32F10X_MD。如果你拿的是 STM32F103RC，Flash 256KB，属于大容量，启动文件用startup_stm32f10x_hd.s，宏用STM32F10X_HD。启动文件和宏不匹配，常见现象是编译能过但中断不响应，或者链接时报向量表相关错误。标准库版本建议用较常见的 3.5.0，网上模板多，stm32f10x_conf.h里默认把外设头文件都 include 了，前期学习不用急着裁剪。
2.2 新建uVision工程并选芯片
目录准备好后，打开 Keil5，点 Project -> New uVision Project，定位到Project文件夹，输入工程名，比如Template。弹窗会问你 Select Device，搜索 STM32F103C8，选中后点 OK。接下来很多人会遇到 Manage Run-Time Environment 窗口，这里如果使用标准库，建议直接关闭或不勾选任何组件，因为标准库文件我们手动添加，RTE 再给你加一份 CMSIS 和启动文件，容易出现重复定义。关掉之后工程窗口里只有一个 Target 1，里面空空的，这是正常的。此时先点 Project -> Save 保存工程，确保.uvprojx已经落在Project目录。若 Select Device 里找不到芯片，回 Pack Installer 装 STM32F1 系列 DFP；若提示路径无效，检查工程路径有没有中文、空格或权限问题。选芯片这一步决定了 Keil 默认的 ROM/RAM 地址和部分预定义宏，所以不能随便选一个“差不多”的型号。
2.3 添加启动文件与库文件
在左侧 Project 窗口右键 Target 1，选 Manage Project Items。先建 Groups，我一般建User、CMSIS、FWlib、Startup四组。然后在User里加main.c、stm32f10x_it.c；在CMSIS里加system_stm32f10x.c；在Startup里加startup_stm32f10x_md.s；在FWlib里加需要的外设.c，比如stm32f10x_gpio.c、stm32f10x_rcc.c、misc.c。新手常犯的错误是把 FWlib 里所有.c全加进去，结果编译慢、Flash 占用大，还容易因为没用的外设中断函数缺失而报错。更稳的做法是用哪个加哪个，前期点灯只需 GPIO、RCC、misc 三个。添加文件时注意路径，Keil 只记录相对路径最好，换电脑或挪目录后不容易失效。main.c可以先写一个最简框架：
#include "stm32f10x.h" void Delay(__IO uint32_t nCount) { for(; nCount != 0; nCount--); } int main(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); 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); } }这段代码能不能编过，取决于后面的宏和头文件路径。如果stm32f10x.h找不到，或者GPIO_InitTypeDef未定义，不要急着改代码，先查 C/C++ 配置。
2.4 配置C/C++宏与头文件路径
点 Options for Target，进入 C/C++ 选项卡。Define 里填两个关键宏：USE_STDPERIPH_DRIVER, STM32F10X_MD。USE_STDPERIPH_DRIVER的作用是让stm32f10x.h去包含stm32f10x_conf.h，从而把标准库外设头文件引进来；STM32F10X_MD告诉库当前是中容量芯片，选错会导致寄存器地址、中断向量数量不匹配。Include Paths 里加三个路径：..\CMSIS、..\FWlib\inc、..\User。这里的..是相对.uvprojx所在目录的上一级，所以路径写法取决于你的工程文件放在哪。很多人复制别人工程后编译报 “cannot open source input file stm32f10x.h”，九成是 Include Paths 没改。优化等级调试阶段选 Level 0，发布再考虑 Level 1 或 Level 2；勾选 C99 Mode 对现代写法友好；Warning 可以选 All Warnings，前期多看点警告没坏处。若芯片外部晶振不是 8MHz，还要检查stm32f10x.h里的HSE_VALUE，这个值影响系统时钟和串口波特率，不改会表现成串口乱码。
2.5 下载配置与首次烧录
编译通过只是第一步，下载配置才是新手容易翻车的地方。Options for Target -> Debug，选择你实际用的调试器，比如 ST-Link Debugger 或 CMSIS-DAP Debugger。点 Settings，在 Debug 页确认能识别到芯片 ID。再到 Flash Download 页，勾选 Program、Verify、Reset and Run，点 Add 添加 Flash 算法。STM32F103C8T6 通常选STM32F10x Med-density Flash 128K这一类中容量算法，算法容量比实际 Flash 大没关系，关键是系列和密度匹配。Utilities 页勾选 Use Debug Driver，并勾选 Update Target before Debugging。硬件连接上，SWD 至少接 SWCLK、SWDIO、GND、3.3V，BOOT0 拉低，目标板单独供电或调试器供电要确认电压一致。首次下载若提示 “No Cortex-M Device found”，先降 SWD 速度，再查接线和供电；若提示 “Flash Download failed”，多半是算法没加、芯片读保护、复位方式不对或目标芯片被选项字节锁住。下载成功后 LED 不闪，别急着怀疑程序，先确认板子 LED 接的是不是 PC13，以及高电平点亮还是低电平点亮。
3. Target/Output/C/C++/Debug几个选项卡逐项拆解
3.1 Target选项卡：XTAL灰、ROM/RAM、外部晶振
Target 选项卡里有几个值看起来不起眼，实际很关键。IROM1 起始地址通常是0x08000000，大小按芯片 Flash 填，STM32F103C8T6 是0x10000，也就是 64KB；IRAM1 起始0x20000000，大小0x5000，也就是 20KB。填大了链接不报错，但下载或运行会跑飞；填小了可能提示区域溢出。XTAL 输入框在有些芯片包环境下会变灰，这不是故障，通常是因为器件包已经固定了仿真时钟，或者当前配置不依赖它。XTAL 主要影响 Keil 仿真时的外设时序，不决定真实硬件运行频率，真实时钟由system_stm32f10x.c和外部晶振决定。也就是说，XTAL 灰了不用慌，只要代码里的 HSE_VALUE、PLL 配置和板子晶振一致，实际运行就没问题。Operating System 一般选 None，除非你确定要跑 RTX。Use MicroLIB 在标准库裸机工程里可勾可不勾，勾了 printf 重定向简单些，但某些库函数行为不同，建议先不勾，等需要时再开。
3.2 Output与Listing：HEX、Browse Information、编译速度
Output 选项卡里，Create HEX File 建议勾上，方便用外部下载器烧录；Debug Information 必须勾，否则不能源码级调试；Browse Information 勾上后能右键跳转定义，但会明显增加编译时间和工程索引体积。如果你发现 Keil5 编译很慢，先看 Browse Information 是不是全开，再看看 FWlib 是不是加了全部.c。Listing 选项卡可以生成.map文件，排查 Flash/RAM 占用、函数被链接到哪里时很有用。Select Folder for Objects 最好指定到Obj目录，Listings 指定到List目录，不要和源码混在一起，否则清理工程时容易误删。实际项目里我会在调试阶段开 Browse Information，发布编译时关掉；如果电脑性能一般，杀毒软件把 Keil 的UV4.exe和工程目录加入白名单，编译速度会稳定很多。路径太深也会拖慢文件扫描，工程目录层级控制在三到四层以内比较舒服。
3.3 C/C++选项卡：宏定义、优化、警告等级
C/C++ 选项卡是标准库工程的核心。Define 里的STM32F10X_MD必须和启动文件匹配，USE_STDPERIPH_DRIVER决定是否引入标准库外设驱动。若你用了stm32f10x_conf.h，确认它位于 Include Paths 中，否则stm32f10x.hinclude 时会找不到。优化等级方面，Level 0 最贴近源码，单步调试不容易跳行；Level 1 体积和速度平衡；Level 3 可能把变量优化没，调试时看不到值。新手调试点灯、串口，建议 Level 0。One ELF Section per Function 可以让链接器丢弃未用函数，减小体积，但会增加一点编译时间。C99 Mode 建议勾选，写变量声明更自由。警告等级不要关，很多“能编译但运行不对”的问题，编译器早就警告过，比如未初始化变量、函数隐式声明、类型不匹配。Short enums / Plain char 这类选项在嵌入式里很少动，除非有特殊协议对接需求，否则保持默认。
3.4 Debug与Utilities：调试器、Flash算法、复位方式
Debug 选项卡决定用什么工具连接芯片。选 ST-Link Debugger 后，点 Settings 可以看到 SW Device 是否识别到 IDCODE。如果识别不到，先查线序、供电、BOOT0，再降 SWD 时钟。Flash Download 页的 Programming Algorithm 必须和芯片匹配，STM32F1 系列常见算法有 Low-density、Med-density、High-density、Connectivity line 等。算法选错，下载时会提示地址范围错误或直接失败。Reset 方式里，Autodetect 通常够用，遇到下载后不运行可以试 SYSRESETREQ 或 VECTRESET。Utilities 页要勾 Use Debug Driver，并确认 Settings 里的下载算法同样存在。若芯片被读保护，需要先解除保护，但解除会全片擦除，操作前必须确认没有需要保留的数据。调试时勾选 Reset and Run，下载完自动运行；若做 Bootloader 调试，可能要关掉，避免复位后直接跳进应用区影响观察。
4. 用CubeMX新建Keil5工程：更省事的路线
4.1 CubeMX工程参数与时钟树
CubeMX 新建工程的逻辑和手动标准库不同，它是先选芯片或开发板，再配置外设，最后生成代码和 IDE 工程。打开 CubeMX，File -> New Project，在 Part Number 里搜 STM32F103C8，选中后开始配置。先到 System Core -> SYS，Debug 选 Serial Wire，否则生成后 SWD 可能被禁用；RCC 里 HSE 选 Crystal/Ceramic Resonator，对应外部晶振。再到 Clock Configuration，把 HSE 输入频率改成板子实际值，比如 8MHz，然后配置 PLL，让 HCLK 到 72MHz。时钟树不要凭感觉拖，STM32F1 的 USB、ADC 等外设有自己的时钟上限，超了会工作异常。GPIO 里点 PC13 设为 GPIO_Output，用于点灯测试。工程名和路径同样不要中文、空格，Project Manager 里 Toolchain/IDE 选 MDK-ARM V5，也就是 Keil5 能打开的工程格式。
4.2 生成MDK-ARM工程的关键选项
Code Generator 页有几项影响后续维护。Copy only necessary library files 推荐勾上，工程体积小，库文件跟工程走，换电脑不容易缺文件；Generate peripheral initialization as a pair of .c/.h files 适合模块化，每个外设初始化单独文件；Generate under root 按需选择，不勾会在工程目录下建Core、Drivers等子目录。生成后你会得到MDK-ARM文件夹，里面有一个.uvprojx，双击用 Keil5 打开。此时不需要再手动加标准库，CubeMX 已经把 HAL 库、启动文件、系统文件、main.c、stm32f1xx_it.c都组织好了。Keil 工程里的 Define 通常会有STM32F103xB、USE_HAL_DRIVER，Include Paths 也已经配好。你只需要确认下载器和 Flash 算法，就能编译下载。注意 CubeMX 生成的代码有USER CODE BEGIN和USER CODE END注释，自己的代码必须写在两者之间，否则重新生成会被覆盖。
4.3 Keil5打开后要改什么
CubeMX 工程用 Keil5 打开后，第一件事是看 Options for Target 里的芯片型号是否正确，ROM/RAM 是否和实际芯片一致。第二是 Debug 里选对调试器，Flash Download 加对算法。第三是编译一次，看有没有缺 Pack、缺 ARM Compiler 版本的问题。Keil5 不同版本自带的 ARM Compiler 不同，老 CubeMX 工程用 AC5，新 Keil 可能默认 AC6，报错风格会变。遇到#include "stm32f1xx_hal.h"找不到，先看 Include Paths，再看 Drivers 文件夹是否完整。HAL 工程里main.c的while (1)中不要随便删HAL_Delay，它依赖 SysTick 中断。若下载后程序不跑，检查 Boot 引脚、复位电路和时钟配置。标准库和 HAL 工程最大的区别是：标准库让你亲手搭骨架，CubeMX 帮你搭骨架，但调试器、下载算法、硬件连接这些底层问题，两条路线都绕不开。
5. 常见问题速查与排查实录
5.1 新建不了工程/找不到芯片
“keil5为什么新建不了工程”通常不是 Keil 本身坏了，而是环境问题。常见原因有：Pack Installer 里没装对应芯片 DFP，Select Device 列表为空；工程路径含中文、空格或特殊符号，Keil 创建文件失败；工程名重复或非法字符；Keil 安装不完整，缺少编译器组件；权限不足，无法在 C 盘写入；同时装了 C51 和 MDK，快捷方式指向了另一个版本。排查顺序是先看 Pack，再看路径，再看权限，最后看安装。下面表格整理高频现象：
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| Select Device 找不到芯片 | DFP 未装或版本旧 | Pack Installer 搜索并安装 STM32F1 DFP |
| 新建时提示 cannot create project | 路径中文、空格、权限 | 换到英文短路径，避开 C 盘系统目录 |
| 打开工程提示 missing device | 芯片包被卸载或版本不匹配 | 重装对应 DFP，检查 Keil 版本 |
| 工程建完空无一物 | 未手动加文件或 CubeMX 未生成 | 标准库手动 Add Files，CubeMX 重新生成 |
| 快捷方式打开的是 C51 | 两个 Keil 版本混淆 | 从 MDK 安装目录启动 uVision，或重命名快捷方式 |
5.2 编译报错/编译很慢/左侧目录不显示
编译报错先看第一行，不要从最后一行倒着看。cannot open source input file是头文件路径问题；undefined symbol是.c没加或宏没开；multiply defined是文件重复添加；no section to be FIRST多半是启动文件没加或链接顺序乱。左侧目录不显示，先看 View -> Project Window 是否打开，再确认打开的是.uvprojx而不是单独某个.c。如果 Project 窗口在但里面空白，可能是文件组被折叠，或者工程文件损坏，从备份恢复。编译很慢的排查顺序是：关 Browse Information、减少 FWlib 文件、清理 Obj/List、杀毒白名单、缩短路径、升级电脑硬盘。标准库工程把全部外设.c加进去，再开 Browse Information，在旧电脑上编译几十秒很正常。若只想快速点灯，只加 GPIO、RCC、misc，编译会快很多。XTAL 灰的问题前面讲过，它不是编译报错根源，不用为了点亮一个输入框折腾半天。
5.3 烧录失败/下载器识别不到
烧录失败是最让人焦虑的，因为编译明明 0 errors。先分三层查：电脑到调试器、调试器到目标板、目标板到芯片。电脑到调试器看 USB 驱动、设备管理器是否识别、换线换口；调试器到目标板看 SWCLK、SWDIO、GND、3.3V 是否接对，线是否过长，SWD 速度是否过高；目标板到芯片看供电、BOOT0、复位引脚、晶振是否起振。Keil 里常见错误 “No Cortex-M Device found” 通常是连接或供电问题；“Flash Download failed” 多是算法、读保护、复位方式问题；“Cannot Load Flash Programming Algorithm” 是没加算法或算法路径失效。若芯片被读保护，需要解除保护并全片擦除。若下载后不运行，检查 Reset and Run、BOOT0、向量表偏移、HEX 是否真的更新。表格如下：
| 报错/现象 | 优先排查 | 补充动作 |
|---|---|---|
| No Cortex-M Device found | 供电、SWD 接线、SWD 速度 | 降速，换短杜邦线，查 BOOT0 |
| Flash Download failed | Flash 算法、读保护、复位方式 | 添加正确算法，解除保护，改 Reset |
| 下载成功但不运行 | BOOT0、复位、时钟、LED 极性 | 手动复位，检查 HSE_VALUE |
| 调试器时好时坏 | USB 线、接口松动、目标板干扰 | 换线，加地线，降 SWD 时钟 |
| 识别到 ID 但下载报错 | 算法容量与芯片不匹配 | 换 Med-density/High-density 算法 |
5.4 C51与STM32共存、版本与授权注意
很多人电脑里既要开发 51，又要开发 STM32，于是关心 Keil5 能不能同时装 C51 和 MDK。实际使用中，建议把 C51 和 MDK 分目录安装，各自用对应快捷方式启动，工程文件也分开管理。C51 的工程文件和 MDK 的.uvprojx不是一回事，不要互相打开。芯片包按需安装，不用一口气全装，Pack 太多会拖慢启动和索引。授权方面按官方方式处理，评估版或正版授权都能正常新建、编译、下载，不要使用来源不明的补丁，否则 Pack 更新、编译器组件、调试驱动都可能被破坏。若公司项目，优先使用合规授权和稳定版本，不要追最新版追到一半发现老芯片包不兼容。版本选择上，Keil5 的 MDK 版本和 ARM Compiler 版本会影响老工程编译，接手老项目时先确认原来用的编译器版本，再决定是否迁移到 AC6。
6. 实操心得：把工程模板做成自己的起跑线
6.1 我常用的目录模板与命名
新建工程最省时间的方式，不是每次从零开始，而是维护一个自己的模板。我的模板里固定有User、CMSIS、FWlib、Project、Obj、List六个目录，User里放main.c、stm32f10x_conf.h、stm32f10x_it.c、board.c/h。board.c/h用来放 LED、按键、串口这些硬件抽象，main.c只保留业务逻辑。命名上我习惯用“芯片_库_用途_日期”，比如F103C8_StdPeriph_LED_202501，一眼能看出工程来历。Obj 和 List 目录不纳入版本管理，只保留源码和工程文件。模板复制后，先改工程名，再改 C/C++ 宏和启动文件，最后改下载算法。这个流程做过三五次后，新手也能在十分钟内搭出一个干净工程。不要小看目录模板，工程一多，最怕的就是每个工程目录结构都不一样，找文件像开盲盒。
6.2 宏定义、启动文件、库版本的匹配表
标准库工程最容易错的就是芯片容量、启动文件、宏定义、Flash 算法四者不匹配。下面这张表建议贴在项目笔记里：
| 芯片示例 | Flash 容量 | 启动文件 | 宏定义 | Flash 算法倾向 |
|---|---|---|---|---|
| STM32F103C8T6 | 64KB | startup_stm32f10x_md.s | STM32F10X_MD | Med-density |
| STM32F103RBT6 | 128KB | startup_stm32f10x_md.s | STM32F10X_MD | Med-density |
| STM32F103RCT6 | 256KB | startup_stm32f10x_hd.s | STM32F10X_HD | High-density |
| STM32F103ZET6 | 512KB | startup_stm32f10x_hd.s | STM32F10X_HD | High-density |
| STM32F103VGT6 | 1MB | startup_stm32f10x_xl.s | STM32F10X_XL | XL-density |
库版本也要一致，标准库 3.5.0 的文件不要和旧版 3.4.0 混用，启动文件和stm32f10x.h最好来自同一个库包。HAL 工程则由 CubeMX 固件包决定，STM32F103xB这类宏不要手改，改了可能导致寄存器映射错乱。每次新建工程，先确认这四件事，比编译报错后再回头查省太多时间。
6.3 备份、版本管理和复用技巧
工程建好并且能下载后，立刻备份一份“裸模板”，不要等代码写多了再抽。备份内容包括.uvprojx、.uvoptx、源码、库文件、启动文件、stm32f10x_conf.h。如果使用 Git，把 Obj、List、.uvoptx里跟个人窗口相关的部分按需忽略，保留.uvprojx方便别人打开。每次新建项目，从模板复制后先改工程名和目录，再在 Keil 里重新确认 Include Paths，因为相对路径在复制后一般不变，但工程名变了要重新保存。对于 CubeMX 工程，保留.ioc文件，重新生成时才有依据。最后一个很实用的小技巧：在User里放一个bsp_led.c/h，把 GPIO 初始化、开灯、关灯、翻转封装成函数，这样下次换板子只改 BSP，不用动main.c。我这些年维护老工程，最庆幸的就是早期养成了模板和 BSP 分离的习惯，新建工程不再是折磨，而是几分钟就能进入写业务代码的状态。
