第3章开发环境搭建

第3章开发环境搭建：Keil/IAR/STM32CubeIDE 安装与配置、交叉编译工具链、调试器（J-Link/ST-Link）配置

说实话，很多初学者一上来就急着写代码，结果卡在环境搭建上大半天。我见过不少同事，明明代码逻辑没问题，就是编译不过，最后发现是工具链没配对。这一章，咱们就把这些基础工作一次性搞定。

3.1 三大IDE的选择与安装

做嵌入式开发，IDE就像你的工具箱。选哪个？我个人习惯看项目需求来定。

3.1.1 Keil MDK

Keil在ARM Cortex-M系列里用得最广。为什么？因为它的编译器优化做得好，调试体验也顺滑。

安装要点：

去ARM官网下载MDK-ARM最新版（目前是5.38或6.x系列）
安装时记得勾选「Cortex-M系列器件支持包」
破解？嗯，我建议用正版评估版，或者找学校/公司申请License

我曾经踩过的坑： 安装路径不要有中文！不要有空格！否则编译时会报一些莫名其妙的错误，比如找不到头文件。我当年在「D:\我的项目\药盒代码」这个路径下折腾了整整一下午。

3.1.2 IAR Embedded Workbench

IAR的编译器优化能力比Keil还要强一点。如果你对代码体积有极致要求，比如Flash只剩2KB了，IAR能帮你再挤出几百字节。

安装注意：

IAR分不同架构版本，ARM版才能编译STM32
安装后需要注册License，否则有代码大小限制（ARM版限制32KB）
建议勾选「EWARM - Full Edition」

说白了，IAR和Keil就像奔驰和宝马，各有拥趸。我个人觉得，如果你刚入门，先选Keil就行，资料多、问题好搜。

3.1.3 STM32CubeIDE

这个是ST官方出的免费IDE，基于Eclipse。最大的好处是——免费！而且集成了CubeMX，可以直接图形化配置外设。

安装步骤：

从ST官网下载STM32CubeIDE安装包（约1.2GB）
双击安装，一路Next
安装时会自动下载GCC交叉编译工具链
首次启动会提示选择工作空间（Workspace），建议单独建一个文件夹

小技巧： 如果你用STM32CubeIDE，建议把自动更新关掉。否则每次打开都检查更新，慢得要命。在Window → Preferences → Install/Update里取消勾选即可。

3.2 交叉编译工具链配置

交叉编译，说白了就是在PC上编译出能在ARM芯片上跑的程序。你想想看，你的电脑是x86架构，药盒里的STM32是ARM架构，编译器得知道这个区别。

常用的工具链：

工具链	适用IDE	特点
ARMCC (armclang)	Keil MDK	ARM官方编译器，优化好，但收费
IAR C/C++ Compiler	IAR EWARM	代码密度最优，收费
GCC ARM Embedded	STM32CubeIDE / 命令行	免费开源，社区活跃

配置GCC工具链（以STM32CubeIDE为例）：

// 查看当前工具链路径
// 一般在安装目录下的 plugins 文件夹里
// 例如：C:\ST\STM32CubeIDE_1.13.0\plugins\com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.11.3.rel1.win32_1.0.0.202310191458\tools\bin

// 验证是否安装成功
arm-none-eabi-gcc --version
// 输出类似：arm-none-eabi-gcc (GNU Tools for STM32) 11.3.rel1

核心概念： 交叉编译工具链的命名规则是「架构-厂商-系统-工具名」。比如 arm-none-eabi-gcc 表示：ARM架构、无特定厂商、嵌入式ABI接口、GCC编译器。记住这个规律，以后看到类似名字就不会懵了。

3.3 调试器配置：J-Link与ST-Link

调试器就是你的「眼睛」。没有它，你只能靠printf猜程序跑到了哪里。我刚开始做项目时，有一次程序跑飞了，硬是打了20多个printf才定位到问题。后来换了调试器单步跟踪，5分钟就找到了。

3.3.1 ST-Link配置

STM32开发板（比如Nucleo、Discovery系列）都板载了ST-Link。如果你自己画板子，也可以单独买一个ST-Link V2或V3。

Keil下配置步骤：

点击「Project → Options for Target」
选择「Debug」选项卡
在「Use」下拉框中选择「ST-Link Debugger」
点击「Settings」，确认SWD模式，速度建议选4MHz
在「Flash Download」里添加对应的Flash算法文件

注意： 如果你用的是STM32G0或G4系列，记得更新ST-Link固件。我遇到过好几次，老版本固件不识别新芯片，连上后一直报「No target connected」。去ST官网下载「ST-Link Upgrade」工具就能解决。

3.3.2 J-Link配置

J-Link是SEGGER公司的产品，调试速度快，功能也更强。如果你做项目需要频繁调试，我个人更推荐J-Link。

IAR下配置步骤：

打开IAR，右键项目 → Options
选择「Debugger」分类，Driver选「J-Link/J-Trace」
进入「J-Link/J-Trace」子页面，Interface选SWD
Speed建议选Auto，或者手动设成4000kHz
在「Images」里指定.hex或.elf文件路径

常见问题排查：

连不上？检查接线：SWDIO、SWCLK、GND三根线必须接，VCC可选
速度太慢？降低SWD时钟频率，有时候线太长会导致信号衰减
识别不到芯片？看看芯片是不是进入了低功耗模式，按一下复位键再试

我的经验： 调试线越短越好。超过20cm的杜邦线，在高速调试时经常掉线。我后来直接焊了一排排针，用排线连接，再也没出过问题。

3.4 验证环境是否搭建成功

环境配好了，怎么知道能不能用？写个最简单的程序跑一下。

// 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);
        HAL_Delay(500);  // 500ms闪烁一次
    }
}

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);
}

编译通过后，点击下载。如果板子上的LED开始以0.5秒间隔闪烁，恭喜你，环境搭建成功了！

嗯，到这里，开发环境这块就基本搞定了。下一章咱们开始真正接触STM32的硬件架构，我会带你看看芯片内部到底长什么样。

📚 课程目录