keil mdk5（常称keil5）作为arm cortex-m系列嵌入式开发最主流的集成开发环境，工程创建是初学者迈入实战的第一道门槛。许多常见报错——如“no target connected”“undefined identifier”“startup file not found”——往往并非代码问题，而是工程搭建阶段疏漏所致。下面将从底层逻辑出发，系统梳理一套稳健、可复现的全流程。
前期准备：筑牢根基，规避90%隐性错误
✅ 许可证与器件包就绪
确保Keil5已成功激活（License Management中显示有效状态），并已通过Pack Installer安装目标MCU对应的Device Family Pack（DFP）。例如开发STM32F407，需安装 STM32F4xx_DFP；开发GD32F303，则需 GD32F3xx_DFP。未安装DFP时，在芯片选型界面将无法列出对应型号，强行跳过会导致启动文件缺失、寄存器头文件（如stm32f407xx.h）无法识别。
✅ 路径规范先行
项目根目录必须为纯英文、无空格、无特殊字符。强烈建议使用类似 D:\Projects\STM32F4_LED_Blink 的结构。中文路径（如“桌面/我的工程”）极易引发编译器路径解析失败、调试器驱动加载异常，甚至导致.hex文件生成中断。同时，提前规划子目录：/Src（源码）、/Inc（头文件）、/Output（编译输出）、/Lib（库文件），提升工程可维护性。
新建工程：四步闭环，拒绝盲目点击
1️⃣ 启动uVision5 → 点击 Project → New uVision Project；
2️⃣ 在弹出窗口中，定位至你已创建的英文路径文件夹（如 D:\Projects\STM32F4_LED_Blink），输入工程名（如 LED_Project），保存为 .uvprojx 文件；
3️⃣ 进入芯片选择对话框：左侧展开厂商（如 STMicroelectronics → STM32F4 Series），双击或选中具体型号（如 STM32F407VGTx），点击 OK；
4️⃣ 弹出提示 “Copy startup code to project folder?” —— 务必选“Yes”。Keil将自动拷贝匹配的 startup_stm32f407xx.s 并加入工程，这是保障 Reset_Handler 正确跳转至 main() 的关键一步，手动添加易错配版本。
工程配置：三处必调，缺一不可
点击工具栏 ? Options for Target（魔法棒图标），依次配置：
? Output 选项卡：勾选 Create HEX File（烧录必备）；在 Select Folder for Objects 中指定输出路径为 /Output 子目录，避免 .axf、.hex、.map 等文件散落工程根目录；
? C/C++ 选项卡：点击 Include Paths 右侧按钮（…），逐条添加所有含头文件的路径，例如：
.\Inc .\Lib\CMSIS\Device\ST\STM32F4xx\Include .\Lib\CMSIS\Include
漏加任一路径，编译器即报 fatal error: xxx.h: No such file or directory；
? Target 选项卡：核对 Crystal Oscillator 值（如8MHz）是否与开发板实际晶振一致；确认 IRAM1 / IROM1 起始地址与大小与芯片数据手册一致（如STM32F407VG：IROM1=0x08000000, Size=0x100000），此设置直接影响链接脚本 .sct 的生成逻辑。
代码组织与验证：最小闭环验证法
- 在工程窗口右键 Target 1 → Add New Item to Group 'Source Group 1'，新建
main.c；或右键 → Add Existing Files to Group 'Source Group 1'，导入已有源码； - 编写极简验证代码（如裸机GPIO翻转），保存后点击 Build（F7）；
- 观察底部 Build Output 窗口：若显示
0 Error(s), 0 Warning(s)且生成LED_Project.hex，即标志工程骨架完全打通；后续可无缝接入调试器（ST-Link/J-Link）进行单步、断点、变量监视等深度开发。
提示：若首次编译失败，请优先检查三项——芯片型号是否与DFP版本匹配、启动文件是否已自动加入、头文件路径是否完整覆盖CMSIS与设备厂商目录。这些细节，正是区分“能跑通”与“真懂原理”的分水岭。
