从零开始：手把手教你用 IAR 创建第一个嵌入式工程
你刚完成IAR 下载，打开软件却一脸茫然？界面复杂、选项繁多，不知道第一步该点哪里？别急——这几乎是每个嵌入式新手都会经历的“入门阵痛”。
本文不讲空话，也不堆术语。我们直接上手，以 STM32F103C8T6（俗称“蓝丸”）为例，带你一步步从空白界面创建一个能编译、能下载、能让 LED 闪烁的完整工程。全程实操导向，连最容易忽略的细节都给你标出来。
为什么是 IAR？它比 Keil 和 GCC 强在哪？
在进入操作前，先搞清楚一件事：我为什么要用 IAR？
简单说，IAR Embedded Workbench 不是“又一个 IDE”，而是为极致性能优化而生的专业工具链。它的 ICC 编译器对代码压缩和执行效率的调优能力，在工业控制、汽车电子等高可靠性场景中备受青睐。
举个例子：
同样一段 HAL 库驱动代码，GCC 可能生成 28KB 的二进制文件，Keil MDK 约 26KB，而 IAR 经常能做到23KB 以下。省下的这几千字节 Flash 空间，对于资源紧张的 MCU 来说，可能就是能否集成新功能的关键。
再加上其出色的调试稳定性、低功耗分析支持和智能断点管理，IAR 成为许多高端项目的首选开发环境。
但代价也很明显：学习曲线陡峭，配置项多且分散。所以今天这篇教程的目标很明确——帮你绕过所有坑，快速跑通第一个工程。
第一步：启动 IAR，创建空工程
打开 IAR Embedded Workbench（假设你已完成安装），你会看到主界面。
⚠️ 注意：不同版本 UI 略有差异，本文基于 IAR for ARM 9.x 版本，但流程通用。
操作路径：
File → New → Project弹出窗口如下：
- Project type：选择
Empty project - Target processor：点击下拉菜单，逐级展开：
ARM → STMicroelectronics → STM32F1 → STM32F103 → Medium density → STM32F103C8
这个路径必须选准！特别是“Medium density”这一级，STM32F103C8 属于中等密度产品线，如果误选成 High-density，链接脚本和启动文件就不匹配，后续会出大问题。
确认后点击 “OK”。
第二步：保存工程，命名要规范
系统会提示你保存.ewp文件（IAR 工程文件）。建议做法：
- 工程名清晰表达用途，比如
Blink_LED_STM32F103 - 路径尽量短且不含中文或空格，例如：
D:\Projects\STM32\Blink_LED_STM32F103\
此时项目结构为空，只有两个核心文件：
-Blink_LED_STM32F103.ewp—— 工程描述
-Blink_LED_STM32F103.eww—— 工作区配置
接下来我们要往里面加东西。
第三步：添加源码文件，别漏了关键组件
右键左侧 Project 栏中的工程名 →Add→Add New File或Add Existing Files
你需要至少添加以下几个文件：
| 文件类型 | 示例文件名 | 来源说明 |
|---|---|---|
| 主程序 | main.c | 自行新建 |
| 启动文件 | startup_stm32f10x_md.s | STM32 官方固件包提供 |
| 系统初始化 | system_stm32f1xx.c | 固件包 CMSIS 目录下 |
| HAL 驱动 | .c/.h文件若干 | STM32CubeF1 包中的 Drivers 文件夹 |
💡 提示：这些文件可以从 ST 官网下载 STM32CubeF1 获取。
将上述文件复制到你的工程目录中，并通过 IAR 添加进去。注意：
-.s汇编文件必须加入，否则没有中断向量表；
- 所有.c文件都要添加，否则函数无法链接；
-.h头文件不需要手动添加，只需确保编译器能找到它们的路径。
第四步：设置头文件搜索路径（关键！）
这是新手最常犯错的地方之一：明明写了#include "stm32f1xx_hal.h"，却报错 “cannot open source file”。
原因很简单：编译器找不到头文件在哪里。
解决方法：告诉 IAR 去哪找这些.h文件。
操作路径：
右键工程名 → Options → C/C++ Compiler → Preprocessor在Additional include directories中添加以下三条路径（根据你的实际目录调整）：
$PROJ_DIR$\..\CMSIS\Device\ST\STM32F1xx\Include $PROJ_DIR$\..\CMSIS\Include $PROJ_DIR$\..\Drivers\STM32F1xx_HAL_Driver\Inc🔍 解释一下
$PROJ_DIR$：这是 IAR 内置变量，表示当前工程所在目录。使用它可以避免硬编码绝对路径，提升工程可移植性。
✅ 添加完成后，再编译就不会出现“找不到头文件”的错误了。
第五步：定义宏，激活正确的芯片配置
仅包含头文件还不够。STM32 的 HAL 库是通用的，需要用宏来指定具体型号。
仍在Options → C/C++ Compiler → Preprocessor页面中，找到Defined symbols，添加以下两个宏：
STM32F103xB USE_HAL_DRIVER这两个宏的作用分别是：
STM32F103xB：触发stm32f1xx.h中对该系列芯片的寄存器映射；USE_HAL_DRIVER：启用 HAL 库相关的初始化代码段。
⚠️ 重点提醒：大小写敏感！必须是
STM32F103xB，不能写成stm32f103xb或STM32F103CB（后者对应的是 High-density 型号）。
如果你写错了，HAL 初始化时可能会读到错误的时钟频率或外设基地址，导致系统行为异常。
第六步：配置链接器与输出格式
链接器决定了你的程序如何分配内存（Flash 和 RAM），以及最终生成什么格式的文件。
1. 指定链接脚本（ICF 文件）
进入：
Options → Linker → Config勾选Override default，然后输入：
$TOOLKIT_DIR$\config\linker\ST\stm32f10x_md.icf或者你可以把这份.icf文件复制到本地工程目录，便于后期修改内存布局（如自定义 Bootloader 分区）。
.icf是 IAR 特有的链接配置文件，内容类似：
define symbol __ICFEDIT_int_flash_start__ = 0x08000000; define symbol __ICFEDIT_int_flash_size__ = 0x00010000; // 64KB define symbol __ICFEDIT_int_sram_start__ = 0x20000000; define symbol __ICFEDIT_int_sram_size__ = 0x00005000; // 20KB这些数值必须与你使用的 MCU 实际资源一致，否则链接会失败或运行崩溃。
2. 生成 HEX 文件（方便烧录）
切换到Output选项卡：
- 勾选Generate additional output
- Format: 选择
other - 在下方输入框填写：
format = intel_extended这样每次构建后都会生成.hex文件，可用于 J-Flash、STVP 等通用烧录工具。
第七步：设置调试器，让程序真正跑起来
最后一步，也是最关键的一步：调试配置。
进入：
Options → Debugger关键设置如下：
| 设置项 | 推荐值 | 说明 |
|---|---|---|
| Driver | ST-Link或J-Link/J-Trace | 根据你用的调试器选择 |
| Connection | SWD | 几乎所有 STM32 板子都用 SWD 接口 |
| Download to flash | ✅ 勾选 | 修改代码后自动下载到 Flash |
🛠 小技巧：如果不勾选 “Download to flash”，每次改完代码还得手动点击 “Load” 才能更新 Flash，非常麻烦。务必开启！
此外，可在Breakpoints选项卡中设置优先使用硬件断点，避免因 Flash 不支持软件断点而导致断点失效。
写代码：点亮 LED，验证一切正常
现在工程框架搭好了，来写一段最简单的代码测试是否成功。
main.c 内容如下：
#include "stm32f1xx_hal.h" void SystemClock_Config(void); static void MX_GPIO_Init(void); int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); while (1) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); // PC13 接板载 LED HAL_Delay(500); // 每半秒翻转一次 } } void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI; RCC_OscInitStruct.HSIState = RCC_HSI_ON; RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE; HAL_RCC_OscConfig(&RCC_OscInitStruct); RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1; RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_HSI; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1; HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_0); } static void MX_GPIO_Init(void) { __HAL_RCC_GPIOC_CLK_ENABLE(); 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); }这段代码做了三件事：
1. 初始化 HAL 库；
2. 配置内部 HSI 作为系统时钟；
3. 初始化 PC13 引脚为输出模式，控制 LED 闪烁。
构建 & 下载：见证奇迹的时刻
全部设置完毕后，按下快捷键Ctrl + F7进行编译。
如果一切顺利，底部 Build Log 会显示：
Build completed successfully.接着按F5启动调试，IAR 会自动连接目标板、下载程序、停在main()函数第一行。
点击 “Go”（或继续按 F5），你应该能看到板载 LED 开始以 1Hz 频率闪烁！
🎉 恭喜！你已经成功走完了 IAR 开发全流程的第一步。
常见问题与避坑指南
别以为编译通过就万事大吉。以下是新手高频踩坑点，提前预防：
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 报错 “cannot open source file xxx.h” | 头文件路径未添加 | 检查Additional include directories是否完整 |
| 链接时报错 “undefined symbol” | 忘记添加.c文件 | 确认所有源文件已加入工程（尤其是system_stm32f1xx.c） |
| 程序无法下载到 Flash | 未启用 Download to flash | 在 Debugger 选项中勾选对应选项 |
| 断点打不上 / 单步跳过 | 使用了软件断点但 Flash 不支持 | 切换至硬件断点，或检查调试器权限 |
| HAL_Delay() 不工作 | SysTick 未初始化 | 确保调用了HAL_Init()，它会自动配置 SysTick |
还有一个隐藏雷区：优化等级过高导致延时不准确。在 Debug 阶段建议将优化设为None (-On)，Release 阶段再调高。
工程组织建议：让你的项目更专业
随着项目变大，良好的结构至关重要。推荐目录划分方式：
/Blink_LED_STM32F103 ├── Src │ ├── main.c │ ├── system_stm32f1xx.c │ └── startup_stm32f10x_md.s ├── Inc │ └── main.h ├── Drivers │ ├── CMSIS │ └── STM32F1xx_HAL_Driver └── Project └── Blink_LED_STM32F103.ewp优点：
- 源码与工程分离，便于复用；
- 易于纳入 Git 版本控制；
- 团队协作时结构清晰。
同时建议创建两个 Configuration：
-Debug：关闭优化，开启调试信息；
-Release：开启 Level 3 以上优化，减小体积。
结语：这只是开始
完成第一个工程的意义，远不止“灯闪了”这么简单。你已经掌握了嵌入式开发的核心闭环：编码 → 编译 → 链接 → 下载 → 调试 → 验证。
这套流程适用于任何基于 IAR 的 MCU 平台。下一步，你可以尝试：
- 移植到其他型号（如 STM32H7、RA4M1）
- 加入 FreeRTOS 实现多任务
- 使用 IAR 的 Profiler 分析函数执行时间
- 启用 Stack Usage Analysis 防止栈溢出
工具只是手段，真正的价值在于用它创造出稳定可靠的系统。当你熟练掌握 IAR 的每一个细节，你会发现——它不只是一个 IDE，更是通往高性能嵌入式世界的钥匙。
如果你在搭建过程中遇到任何问题，欢迎留言交流。一起进步，才是技术分享的意义所在。
