3. 开发环境搭建：Keil MDK安装与配置、STM32CubeMX安装、驱动安装（ST-Link、J-Link）、第一个工程创建与下载

说实话，很多初学者一上来就急着写代码，结果卡在环境搭建上大半天。我见过不少同事，拿着开发板却点不亮LED，最后发现是驱动没装好。磨刀不误砍柴工，今天咱们就把这套工具链捋顺了。

本章核心目标：装好三样东西——Keil MDK（编译器+IDE）、STM32CubeMX（图形化配置工具）、调试器驱动（ST-Link/J-Link）。然后跑通第一个工程，看到LED闪烁。

3.1 工具链全景图

先看看我们这一整套工具是怎么配合的。我习惯把开发流程画成一张图，这样心里有数。

STM32 开发工具链流程图 STM32CubeMX 图形化配置外设/时钟 生成初始化代码 HAL库 + .ioc 工程 Keil MDK 编译/调试/下载 调试器驱动 ST-Link / J-Link STM32 目标板 下载运行固件 💡 工作流程 CubeMX配置 → Keil编译 → 调试器下载

说白了，CubeMX帮你省掉写初始化代码的苦力活，Keil负责编译和调试，调试器把固件烧进芯片。这三者缺一不可。

3.2 Keil MDK 安装与配置

Keil MDK是ARM公司出的IDE，专门用来开发ARM内核的单片机。我个人习惯用MDK 5.38版本，稳定且对HAL库支持好。

3.2.1 安装步骤

  1. 下载安装包：去Keil官网（www.keil.com）下载MDK-ARM。注意选对版本，别下成C51了。
  2. 运行安装程序：一路Next，路径建议默认。我见过有人改到中文路径，结果编译报错——Keil对中文路径支持不好。
  3. 安装器件包：安装完后打开Keil，点击 Pack Installer，找到你的芯片型号（比如STM32F103C8），点击Install。
  4. 注册许可证：不注册也能用，但有16KB代码限制。买个正版或者用评估版，看个人情况。

⚠️ 我曾经踩过的坑：装完Keil后直接打开工程，发现编译报错“找不到core_cm3.h”。后来发现是器件包没装。记住：装完Keil第一件事就是打开Pack Installer，把对应芯片的包装上。

3.2.2 配置要点

装好后，建议做两件事：

  • 设置编码为UTF-8：在 Edit → Configuration → Editor → Encoding 里选UTF-8。不然中文注释会乱码。
  • 开启语法高亮：默认就开了，但如果你发现代码全是黑白，去 View → Source Browser 里检查一下。

3.3 STM32CubeMX 安装

CubeMX是ST官方出的图形化配置工具。你想想看，以前配置时钟树要翻几百页数据手册，现在点几下鼠标就搞定了。

3.3.1 安装步骤

  1. 下载安装包：去ST官网搜“STM32CubeMX”，下载最新版。需要注册ST账号，免费。
  2. 安装Java运行环境：CubeMX基于Java，所以要先装JRE。我建议装Java 11以上版本。
  3. 运行安装程序：双击安装，路径同样不要有中文。
  4. 更新固件包：打开CubeMX，点击 Help → Manage embedded software packages，下载你需要的STM32系列固件包。

💡 小技巧：CubeMX的固件包很大（一个系列可能几百MB），建议只下载你当前用的系列。比如你玩F1系列，就只下STM32F1的包，别全选。

3.4 调试器驱动安装

调试器是电脑和开发板之间的桥梁。最常用的是ST-Link（ST自家）和J-Link（SEGGER公司）。

3.4.1 ST-Link 驱动

如果你用的是Nucleo板或者Discovery板，板载了ST-Link。驱动安装很简单：

  • 插上开发板，Windows会自动识别。如果没识别，去ST官网下载 ST-Link USB driver。
  • 装好后，在设备管理器里能看到 STMicroelectronics STLink dongle。

3.4.2 J-Link 驱动

J-Link是第三方调试器，速度快、功能强。我项目里用J-Link比较多，尤其是调试复杂项目时。

  • 去SEGGER官网下载 J-Link Software and Documentation Pack。
  • 安装后，插上J-Link，驱动自动装好。
  • 打开 J-Link Commander，如果能识别到芯片，说明驱动正常。

⚠️ 注意：J-Link有盗版克隆版，驱动可能装不上。我建议买正版，或者用ST-Link替代。盗版J-Link在调试时容易掉线，我曾经被坑过一整天。

3.5 第一个工程创建与下载

好了，工具都装齐了。咱们来创建第一个工程——让LED闪烁。这是嵌入式界的“Hello World”。

3.5.1 用CubeMX生成工程

  1. 新建工程：打开CubeMX，点击 New Project。
  2. 选择芯片：在 Part Number 里输入你的芯片型号，比如STM32F103C8。双击选中。
  3. 配置时钟：进入 Clock Configuration 标签页，把HCLK设为72MHz（F103的最高主频）。
  4. 配置GPIO：在 Pinout & Configuration 里，找到PC13引脚（Nucleo板上的LED引脚），设为GPIO_Output。
  5. 生成代码：点击 Project → Generate Code，选择MDK-ARM V5，生成工程。

3.5.2 在Keil中编写代码

生成后，用Keil打开工程。在 main.c 的 while(1) 循环里添加：

HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500);  // 延时500ms

嗯，就这么两行。HAL_GPIO_TogglePin翻转引脚电平，HAL_Delay做延时。LED就会以1秒的频率闪烁。

3.5.3 编译与下载

  1. 编译：点击Keil的 Build 按钮（或者按F7）。看到 0 Error(s), 0 Warning(s) 就说明编译通过。
  2. 配置下载器：点击 Options for Target → Debug，选择 ST-Link Debugger 或 J-Link。然后点 Settings，确认能识别到设备。
  3. 下载：点击 Load 按钮（或者按F8）。下载成功后，开发板上的LED应该开始闪烁。

✅ 验证标准：LED以大约1秒的周期闪烁。如果没亮，检查接线、驱动、工程配置。别慌，90%的问题出在驱动没装好或者引脚配置错了。

3.6 常见问题速查表

问题现象 可能原因 解决办法
编译报错“找不到头文件” 器件包未安装 打开Pack Installer安装对应芯片包
下载时提示“No ST-Link detected” 驱动未装或USB线有问题 重装ST-Link驱动，换USB线
LED不亮 引脚配置错误或硬件连接问题 检查CubeMX引脚配置，核对原理图
J-Link无法识别 盗版J-Link或驱动版本不匹配 换ST-Link或更新J-Link驱动

环境搭建这块，说白了就是一次性的体力活。但别小看它，基础打好了，后面写驱动、调bug才能顺风顺水。我刚开始学的时候，光装Keil就折腾了两天——后来发现是杀毒软件把破解文件给隔离了。嗯，这些坑你们大概率也会遇到，但有了这张速查表，应该能省不少时间。

← 上一章 📖 返回目录 下一章 →