2025年外用贴敷膏厂家直销口碑排行，这份榜单值得收藏，外用理疗贴/定制化贴敷膏/透皮贴敷/经皮给药贴/保健贴敷制剂外用贴敷膏公司排行 - 品牌推荐师
2026/1/3 9:58:27
Keil5创建工程实战全解：从零开始搭建你的第一个STM32项目
你是不是也曾在打开Keil µVision5后，面对那一堆弹窗和选项感到无从下手？点了“新建工程”之后，却卡在选哪个芯片、要不要复制启动文件、RTE到底勾不勾这些问题上？
别担心——这几乎是每个嵌入式新手的必经之路。而今天这篇文章的目的，就是彻底讲清楚Keil5怎么创建一个能编译、能下载、能运行的完整工程，让你不再被“第一步”拦住去路。
我们不堆术语，不说空话，只讲你真正需要知道的操作逻辑与背后原理。全程以STM32F103系列为例，手把手带你走完从零到“Hello World”级点亮LED的全过程。
一、为什么Keil5建工程这么“难”？
很多初学者觉得Keil5复杂，其实不是它本身多难，而是：
- 它把太多底层配置暴露给了用户；
- 没有明确提示“哪些是必须做的”，导致误操作频发；
- 网上教程五花八门，有的用旧版Keil4方式，有的直接跳过关键步骤。
结果就是：代码写好了，一编译报错“undefined symbol SystemInit”；或者程序烧进去却不运行，连main函数都没进。
这些问题，往往都出在工程创建阶段的几个核心环节上。接下来我们就拆开来看，每一个步骤到底该怎么做，以及为什么要这么做。
二、第一步：选对芯片 = 成功一半
当你点击【Project】→【New µVision Project】并选择保存路径后，第一个弹窗叫Device Selection（设备选择）。
✅ 正确做法：在这里精确输入你实际使用的MCU型号，比如
STM32F103C8T6或STM32F103RB。
不要随便选个相近的！因为Keil会根据这个型号自动加载对应的：
- 启动文件（startup_xxx.s）
- 内存布局（Flash/SRAM大小）
- 中断向量表结构
- 默认时钟配置参数
举个例子：如果你板子是STM32F103C8（64KB Flash），但选成了STM32F103ZE（512KB Flash），虽然也能编译通过，但链接器可能会把程序放到超出物理范围的位置，导致运行异常。
📌小贴士：
搜索时建议输入完整前缀如STMicroelectronics STM32F103，避免和其他厂商同名芯片混淆。
三、第二步：启动文件 —— 程序真正的“起点”
点击确定后，Keil通常会弹出一个对话框：
“Copy STARTUP code to project folder and add file to project?”
✅一定要点 Yes！
否则你就得手动添加启动文件（.s文件），稍有疏忽就会出问题。
那么，启动文件究竟是干什么的？
我们知道C语言是从main()开始执行的，但实际上，在main()被调用之前，系统必须完成一系列初始化工作，包括：
| 初始化任务 | 由谁完成 |
|---|---|
| 设置主堆栈指针（MSP） | 启动文件 |
| 建立中断向量表 | 启动文件 |
| 初始化.data段（复制已初始化变量到SRAM） | 启动文件 |
| 清零.bss段（未初始化变量置0） | 启动文件 |
跳转到__main，进而进入main() | 启动文件 |
这些操作全部由汇编写的启动文件完成。典型的复位处理流程如下：
Reset_Handler PROC EXPORT Reset_Handler [WEAK] IMPORT __main LDR R0, =__main BX R0 ENDP所以如果你遇到以下错误：
Error: undefined symbol SystemInit- 程序无法进入
main() - 上电后直接进HardFault
很大概率就是启动文件没加、或不匹配！
🔧验证方法：
在左侧Project侧栏中查看是否包含类似startup_stm32f103xb.s的文件。如果没有，请回头检查是否点了“Copy Startup”。
四、第三步：CMSIS与SystemInit —— 让内核“活起来”
CMSIS（Cortex Microcontroller Software Interface Standard）是Arm为统一Cortex-M开发而制定的标准接口。它的作用就像一套“通用说明书”，让不同厂家的MCU都能用同样的方式访问NVIC、SysTick等内核外设。
在Keil5中，我们通过Run-Time Environment（RTE）来管理这些组件。
如何启用CMSIS？
- 点击菜单栏 【Project】→【Manage Run-Time Environment…】
- 在弹出窗口中展开：
- ✅ Device → Startup
- ✅ CMSIS → Core - 如果使用HAL库，再勾选对应驱动（如
STM32Cube HAL Drivers）
✅ 勾选后，Keil会自动做三件事：
- 添加头文件路径（如CMSIS\Include）
- 引入system_stm32f1xx.c和core_cm3.h等必要文件
- 定义宏（如STM32F103xB,USE_HAL_DRIVER）
其中，system_stm32f1xx.c里定义了SystemInit()函数，它的职责是：
void SystemInit(void) { // 配置HSE、PLL、系统时钟源等 SetSysClock(); #ifdef VECT_TAB_SRAM SCB->VTOR = SRAM_BASE | VECT_TAB_OFFSET; #else SCB->VTOR = FLASH_BASE | VECT_TAB_OFFSET; #endif }⚠️ 注意：SystemInit()是在启动文件之后、main()之前被自动调用的。如果没引入CMSIS Core组件，这个函数就不存在，链接时报错：“unresolved symbol SystemInit”。
这就是为什么很多人编译失败的根本原因——缺了CMSIS支持。
五、第四步：输出配置 —— 生成你能烧录的文件
很多人写完代码一编译，发现没有.hex文件，于是用ST-Link或串口ISP工具烧不了程序。
原因很简单：你没告诉Keil要生成HEX文件！
怎么设置？
右键左侧的 “Target 1” → 【Options for Target】→ 切换到 【Output】选项卡：
- ✅ 勾选Create HEX File
- 可选：勾选Create Batch File（用于自动化构建）
- 输出格式默认即可（AXF用于调试）
💡 顺便提一句：.axf是带调试信息的镜像文件，JTAG/SWD调试器需要用它来设置断点、查看变量；而.hex或.bin是纯二进制格式，适合量产烧录或Bootloader升级。
散加载文件（Scatter File）是什么？
Keil默认使用内置的分散加载规则，但也可以自定义.sct文件来控制内存映射。例如：
LR_IROM1 0x08000000 0x00010000 { ; 64KB Flash ER_IROM1 0x08000000 0x00010000 { *.o (RESET, +First) .ANY (+RO) } RW_IRAM1 0x20000000 0x00005000 { ; 20KB SRAM .ANY (+RW +ZI) } }这段描述的意思是：
- 代码段（RO）放在Flash起始地址0x08000000
- 数据段（RW/ZI）放在SRAM0x20000000
如果不配好这个，程序可能写到非法地址，导致跑飞。
不过对于大多数标准工程，Keil会根据所选芯片自动配置好SCT文件，无需手动干预。
六、第五步：连接调试器 —— 把程序“送进去”
最后一步，当然是把编译好的程序下载到单片机里。
进入 【Options for Target】→ 【Debug】选项卡：
- 选择硬件调试器类型：
- ✅ ST-Link Debugger（最常见）
- J-LINK / ULINK 也可选
- 点击 【Settings】→ 在【Flash Download】页签中确认勾选了你要烧写的算法（如 “STM32F103C8 Flash”）
如果这里显示“No Algorithm Found”，说明：
1. 没正确识别芯片；
2. Flash编程算法未安装（可通过Pack Installer更新DFP包解决）。
一切就绪后，点击工具栏上的Download（Load）按钮（向下箭头图标），即可将程序写入Flash。
🎉 成功标志：下载完成后提示 “Erase Done”、“Program Done”、“Verify OK”。
七、实战演示：写一个最简单的main函数
现在我们来验证整个工程是否正常工作。
新建一个main.c文件，内容如下：
#include "stm32f1xx_hal.h" int main(void) { // 初始化HAL库（若使用HAL） HAL_Init(); // 配置系统时钟（默认使用内部HSI） SystemClock_Config(); // 假设LED接在PB0，开启GPIOB时钟 __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitTypeDef gpio = {0}; gpio.Pin = GPIO_PIN_0; gpio.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出 gpio.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOB, &gpio); while (1) { HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0); for (volatile int i = 0; i < 1000000; i++); } }别忘了还要实现SystemClock_Config()（可从CubeMX复制，或暂时留空使用默认配置）。
编译 → 下载 → 观察LED是否闪烁！
✅ 成功了？恭喜你，已经完整走通了Keil5工程创建全流程！
八、避坑指南：那些年我们都踩过的雷
| 问题 | 原因 | 解决方案 |
|---|---|---|
编译报错undefined symbol SystemInit | 未启用CMSIS Core或缺少启动文件 | 检查RTE是否勾选CMSIS > Core 和 Device > Startup |
| 程序不运行，LED不亮 | 未生成HEX文件或下载失败 | 检查Output选项卡是否勾选Create HEX File |
| HardFault_Handler被触发 | 堆栈溢出、中断优先级冲突、野指针 | 查看Call Stack，检查数组越界、中断嵌套深度 |
| map文件缺失，无法分析内存占用 | 未开启生成map文件 | 在Options → Listing中勾选Generate Map File |
| RTE组件灰色不可选 | 未安装对应DFP包 | 打开Pack Installer，搜索并安装STMicroelectronics STM32F1 Series Device Family Pack |
九、最佳实践建议
为了让工程更规范、易维护，推荐你在创建工程时注意以下几点：
1. 工程命名清晰
不要叫“project1”、“test”这种名字。建议采用格式：
Blink_LED_STM32F103C8_202504052. 目录结构合理
Project_Root/ ├── Core/ │ ├── startup_stm32f103xb.s │ ├── system_stm32f1xx.c │ └── main.c ├── Drivers/ │ └── STM32F1xx_HAL_Driver/ ├── Middlewares/ └── Output/ ← 自动输出文件放这里3. 使用版本控制（Git）
初始化.gitignore文件，排除临时文件：
*.uvprojx.lock *.opt Output/ Listings/4. 统一编码格式
设置编辑器为UTF-8 without BOM，防止中文注释乱码。
5. 备份原始配置
第一次成功编译后，打包备份工程文件，作为模板复用。
写在最后：掌握建工程，才真正入门嵌入式
你会发现，一旦搞懂了Keil5如何创建工程，后续学习RTOS、LVGL、Modbus通信等内容都会变得顺畅许多。
因为你已经理解了：
- 程序是怎么启动的？
- 代码是如何组织的？
- 文件之间的依赖关系是什么？
这才是嵌入式开发的核心思维。
未来你可能会转向更现代化的工具链，比如VS Code + CMake + GCC + OpenOCD，但Keil5依然是国内高校教学、企业开发中最主流的选择之一。熟练掌握它，不仅是为了当下能做出东西，更是为了打好基础，将来无缝迁移到更高阶平台。
如果你正在学习STM32开发，欢迎收藏本文，并动手试一次完整的工程搭建流程。有任何疑问，比如“为什么我的RTE里没有HAL选项？”、“如何添加外部晶振支持？”——都可以在评论区留言，我们一起探讨解决。
毕竟，每一个老工程师，都是从“第一个Keil工程”开始的。