第2章 开发环境搭建：Keil MDK/IAR/VS Code + GCC 工具链安装、工程模板创建、下载与调试配置

说实话，很多初学者在RTOS入门时，第一个拦路虎不是任务调度，也不是信号量，而是——开发环境装不上。我见过太多人卡在这一步，折腾两天连个LED都点不亮，信心直接归零。

这一章，我就带你把这套环境彻底搞定。咱们不讲虚的，直接上手。

2.1 三大主流IDE，我该怎么选？

目前嵌入式开发圈子里，主流工具就这三家：Keil MDK、IAR Embedded Workbench、VS Code + GCC。各有各的脾气，我一个个说。

工具	优点	缺点	适合人群
Keil MDK	ARM官方亲儿子，调试器兼容性好，教程最多	代码量限制（免费版32KB），界面老旧	初学者、STM32用户
IAR EWARM	编译优化极强，代码密度高	价格贵，界面反人类	产品级开发、对代码体积敏感的项目
VS Code + GCC	免费、轻量、插件生态丰富	配置繁琐，新手容易劝退	喜欢折腾的、Linux开发者

我个人习惯是：教学和快速验证用Keil，产品量产用IAR，日常写代码用VS Code。你想想看，三个工具各有各的舞台，没必要非得分个高下。

2.2 Keil MDK安装与工程模板创建

先讲Keil，因为这是国内最普及的。安装步骤其实不复杂，但有几个坑我得提前告诉你。

2.2.1 安装步骤

1. 去ARM官网下载MDK-Arm（注意不是MDK-51，那是51单片机的）
2. 双击安装，一路Next。但安装路径不要有中文和空格。我曾经见过有人装在「C:\程序文件\Keil_v5」下面，结果编译报错找了一下午。
3. 安装完成后，打开Pack Installer，下载你芯片对应的Device Family Pack。比如STM32F4系列，就搜STM32F4。
4. 破解（懂的都懂），输入CID生成License。

2.2.2 创建工程模板

我习惯把工程模板做成「三件套」：启动文件、链接脚本、核心代码。这样每次新建项目，直接复制改改就能用。

// 工程目录结构建议
Project_Template/
├── Libraries/          // 芯片外设库
├── User/               // 用户代码
│   ├── main.c
│   ├── stm32f4xx_it.c
│   └── system_stm32f4xx.c
├── Startup/            // 启动文件
│   └── startup_stm32f407xx.s
├── RTOS/               // RTOS源码（后面章节会加）
└── Output/             // 编译输出

在Keil里新建工程时，记得选对芯片型号。然后手动添加启动文件和链接脚本。嗯，这里要注意：启动文件一定要和芯片型号匹配，不然上电就跑飞。

2.3 IAR安装与配置

IAR这工具，怎么说呢，又爱又恨。爱的是它的编译优化确实牛，同样的代码，IAR编译出来能比Keil小10%-20%。恨的是它的界面设计，我怀疑是上个世纪留下来的。

2.3.1 安装要点

• 下载IAR Embedded Workbench for ARM，版本建议8.4以上
• 安装时选择「Full Installation」，别省那点硬盘空间
• 破解方式和Keil类似，但IAR的License管理更严格

2.3.2 工程模板配置

IAR的工程配置比Keil复杂一些。主要注意这几个地方：

• General Options → Target：选对芯片型号
• C/C++ Compiler → Preprocessor：添加头文件路径
• Linker → Config：指定链接脚本（.icf文件）

我在项目中遇到过一个问题：IAR默认的优化等级是High，结果RTOS的任务栈初始化被优化掉了，导致任务切换直接死机。所以刚开始学RTOS时，建议先把优化等级调到None，等跑通了再慢慢调优。

2.4 VS Code + GCC：免费且强大的方案

如果你不想被Keil的代码限制卡脖子，也不想花大价钱买IAR，那VS Code + GCC就是你的不二之选。说白了，这套方案就是「编辑器 + 编译器」的组合拳。

2.4.1 工具链安装

1. 安装VS Code（这个不用教吧）
2. 安装ARM GCC工具链：去ARM官网下载gcc-arm-none-eabi，解压到某个目录
3. 安装OpenOCD：用于调试和下载
4. 安装Make工具：Windows下可以用MinGW或者Cygwin

配置环境变量这一步，很多人会栽跟头。你想想看，VS Code找不到gcc编译器，那还玩个啥？

// 把以下路径添加到系统环境变量Path中
C:\Program Files (x86)\GNU Arm Embedded Toolchain\10 2021.10\bin
C:\OpenOCD\bin
C:\MinGW\bin

2.4.2 VS Code插件推荐

• C/C++：微软官方，代码补全和调试
• Cortex-Debug：ARM芯片调试利器
• Makefile Tools：管理编译过程
• Hex Editor：查看二进制文件

2.5 下载与调试配置

环境搭好了，代码写完了，怎么烧进去？怎么调试？这是很多人的第二个坎。

2.5.1 调试器选择

调试器	速度	价格	兼容性
J-Link	快	贵（正版）	几乎通吃所有ARM芯片
ST-Link	中等	便宜（几十块）	只支持STM32
DAP-Link	中等	便宜	ARM Cortex全系列

我个人建议：初学阶段用ST-Link就够了，便宜又好用。等以后做产品了，再考虑J-Link。

2.5.2 Keil调试配置

在Keil里，点那个魔术棒图标（Options for Target），然后：

• Debug选项卡：选择调试器（比如ST-Link），点Settings
• Flash Download选项卡：勾选「Reset and Run」，这样下载完程序会自动复位运行

我曾经犯过一个低级错误：忘记勾选「Reset and Run」，每次下载完都要手动按复位键。折腾了半小时才发现，气得我差点把开发板扔了。

2.5.3 VS Code调试配置

VS Code的调试配置稍微麻烦点，需要在.vscode文件夹下创建launch.json文件：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Cortex Debug",
            "cwd": "${workspaceRoot}",
            "executable": "./build/rtos_demo.elf",
            "request": "launch",
            "type": "cortex-debug",
            "servertype": "openocd",
            "configFiles": [
                "interface/stlink-v2.cfg",
                "target/stm32f4x.cfg"
            ]
        }
    ]
}

2.6 避坑指南

最后，我把自己这些年踩过的坑总结一下，你遇到了直接对照着排查：

• 编译报错找不到头文件：八成是路径没加对，检查工程设置里的Include Paths
• 下载失败，提示No Cortex-M SW Device Found：检查接线，特别是SWDIO和SWCLK有没有接反。我刚开始学的时候，把SWDIO和GND接一起了，烧了三个调试器才反应过来。
• 程序跑起来但没反应：先检查时钟配置，很多RTOS对系统时钟有要求。比如FreeRTOS的SysTick中断依赖于正确的时钟频率。
• 调试时无法设置断点：检查优化等级，优化开太高会把代码优化掉，断点自然就失效了。

好了，环境搭建这块就讲这么多。你按照上面的步骤走一遍，应该半天内就能把Keil、IAR、VS Code三套环境都跑通。下一章，我们就正式开始RTOS的旅程了——先从一个最简单的任务调度开始。