Keil MDK工程搭建全攻略：从新建工程到下载调试
Keil MDK是ARM架构单片机（尤其是STM32系列）开发中使用最广泛的集成开发环境。对初学者来说，第一次成功搭建工程、编译、下载并看到板子上的现象，是跨入嵌入式开发门槛的标志性一步。本文用清晰的步骤，带大家从零完成一个STM32工程的搭建，并跑通"编译—下载—调试"全流程。
一、新建工程与芯片选择打开Keil MDK后，通过Project→New uVision Project新建工程，为工程命名并选择保存目录（建议单独建文件夹，方便管理源码和工程文件）。随后在弹出的Device对话框中，按厂家和型号选择目标芯片，例如选择STMicroelectronics下的STM32F103C8。Keil会自动为所选芯片带上对应的启动文件（Startup）和设备头文件。工程创建完成后，左侧Project栏会生成Target、Source Group等结构，初学者通常再手动添加一个组专门存放自己的main.c等用户源码。
二、配置魔法棒（Options for Target）点击魔术棒图标进入工程配置，这是工程能否正确编译的关键。首先是Target选项卡，需要设置芯片型号和外部晶振频率（如8MHz）；然后是Output选项卡，勾选Create HEX File生成HEX烧录文件；C/C++选项卡里可以添加宏定义（如STM32F10X_MD）和头文件包含路径（Include Paths），其中头文件路径配置错误是最常见的编译报错原因之一。Debug和Utilities选项卡则用于选择调试器，常见的有ST-Link、J-Link、DAP-Link等，选择后还需在Settings里设置下载选项。
三、编译与常见错误排查配置完成后点击编译按钮（Build）生成目标文件。如果代码无误，输出窗口会显示0 Error(s), 0 Warning(s)。初学者常遇到的编译错误主要有几类：头文件找不到，通常是没有正确配置Include Paths或文件未加入工程；符号未定义，一般是遗漏了对应源文件或函数声明；语法错误则多为中英文标点混用、括号不匹配。遇到报错时，双击错误信息可以定位到具体代码行，逐条修复即可。编译通过并勾选了Create HEX File后，会在Output目录生成.hex烧录文件。
四、下载程序与在线调试把ST-Link或DAP-Link通过SWD接口连接开发板（注意SWDIO、SWCLK、GND、3.3V四根线的接法），点击Load（或按F8）即可把程序下载到芯片。下载成功后开发板应立即运行程序。若下载失败，优先检查调试器连接、供电和目标芯片型号是否匹配。下载完成后还可以使用Debug模式在线调试：设置断点、单步执行、查看变量和寄存器值，这些手段对排查复杂逻辑问题极为有用。掌握Keil MDK工程搭建与下载调试之后，就可以顺利进入STM32外设开发的正题了。
|
|
|
|
|
|
|
|
|
