3. 开发环境搭建：工欲善其事，必先利其器

说实话，我见过太多初学者在开发环境上栽跟头。明明代码逻辑没问题，就是下载不进去，或者仿真器连不上。折腾半天，最后发现是驱动装错了版本。所以这一章，咱们把环境一次性搭利索。

嵌入式开发不像写个网页，装个浏览器就能跑。你需要编译器、调试器、驱动，还有一堆配置。我个人的习惯是：先把工具链理清楚，再动手装。这样出了问题，也知道去哪找原因。

3.1 开发工具全景图

先看一张整体关系图，你就明白这些工具各司其职了。

从图上你能看到：IDE（Keil 或 CubeIDE）→ 调试器（J-Link/ST-Link）→ 目标板（STM32），这是最核心的链路。任何一个环节断了，程序都跑不起来。

3.2 Keil MDK-ARM 安装与配置

Keil MDK 是 ARM 生态里最老牌的 IDE 之一。很多公司量产项目还在用它。我个人觉得它的编译器优化确实好，尤其对 Cortex-M 内核的代码密度控制得很到位。

3.2.1 下载与安装

1. 获取安装包： 去 Keil 官网（www.keil.com）下载 MDK-ARM 最新版。注意区分 MDK-ARM 和 MDK-ARM Lite（免费版有 32KB 代码限制）。
2. 运行安装： 双击 .exe，一路 Next。安装路径建议默认，不要带中文。
3. 安装器件包： 安装完成后，打开 Pack Installer，找到 STMicroelectronics 目录，勾选你用的芯片型号（比如 STM32F103xx 或 STM32F407xx）。

3.2.2 配置编译器与调试器

装好只是第一步。配置不对，照样没法用。我建议你按以下步骤检查一遍：

3.3 STM32CubeIDE 安装

STM32CubeIDE 是 ST 官方基于 Eclipse 打造的免费 IDE。它集成了 CubeMX 的图形化配置功能，非常适合快速生成初始化代码。说白了，你点点鼠标，HAL 库的初始化代码就自动生成了。

3.3.1 下载与安装

1. 获取安装包： 去 ST 官网搜索 STM32CubeIDE，下载对应操作系统版本（Windows/Linux/macOS）。
2. 安装： 解压后运行安装程序。注意：安装路径同样不要有中文或空格。
3. 首次启动： 会提示选择工作空间（Workspace）。我习惯单独建一个文件夹，比如 D:\STM32_Workspace，方便管理。

3.3.2 与 CubeMX 的集成

CubeIDE 内部直接嵌入了 CubeMX。你新建工程时，它会自动打开图形化配置界面。我个人觉得这是它最大的优势——不用在 CubeMX 和 IDE 之间来回切换。

3.4 J-Link / ST-Link 驱动安装

驱动是连接 IDE 和调试器的桥梁。驱动没装好，IDE 里就找不到调试器。

3.4.1 J-Link 驱动

• 下载： 去 Segger 官网下载 J-Link Software and Documentation Pack。
• 安装： 运行安装包，它会自动安装驱动和 J-Link Commander 工具。
• 验证： 插上 J-Link，打开设备管理器，应该能看到“J-Link driver”设备。或者在命令行运行 JLink.exe，如果能显示 S/N 号，说明驱动正常。

3.4.2 ST-Link 驱动

• 内置驱动： 如果你用 Nucleo 或 Discovery 板，插上 USB 后 Windows 10/11 会自动安装驱动。
• 手动安装： 如果自动安装失败，去 ST 官网下载 ST-Link 驱动包（en.stsw-link009），手动安装。
• 验证： 设备管理器里应该出现“STMicroelectronics STLink dongle”或类似设备。

3.5 第一个工程创建与下载验证

环境都搭好了，咱们来跑第一个程序。我以 Keil MDK 为例，CubeIDE 的流程类似，只是界面不同。

3.5.1 在 Keil 中创建工程

1. 新建工程： Project → New μVision Project，选择工程保存路径，输入工程名（比如 LED_Blink）。
2. 选择芯片： 在弹出的对话框里找到你的芯片型号。比如我用的是 STM32F103C8T6，就选 STM32F103C8。
3. 添加启动文件： Keil 会提示是否添加启动文件，选“是”。
4. 编写代码： 在 main.c 里写一个简单的 LED 闪烁程序。下面是一个最简示例：

#include "stm32f10x.h"

void delay(void) {
    for(uint32_t i = 0; i < 500000; i++);
}

int main(void) {
    // 使能 GPIOC 时钟
    RCC->APB2ENR |= RCC_APB2ENR_IOPCEN;
    // 配置 PC13 为推挽输出
    GPIOC->CRH &= ~(0xF << 20);
    GPIOC->CRH |= (0x3 << 20);

    while(1) {
        GPIOC->BSRR = GPIO_BSRR_BS13;  // 点亮 LED
        delay();
        GPIOC->BSRR = GPIO_BSRR_BR13;  // 熄灭 LED
        delay();
    }
}

3.5.2 编译与下载

1. 编译： 按 F7 或点击 Build 按钮。如果代码没错，底部 Output 窗口会显示 0 Error(s), 0 Warning(s)。
2. 配置下载器： 点击 Options for Target → Debug，选择你的调试器（ST-Link Debugger 或 J-Link）。再点 Settings，确认 SWD 设备已识别。
3. 下载： 按 F8 或点击 Download 按钮。下载成功后，开发板上的 LED 应该开始闪烁。

3.6 常见问题与避坑指南

嗯，到这里，你的开发环境应该已经能正常工作了。我记得第一次成功点亮 LED 的时候，那种感觉确实不错。后面所有的调试、外设驱动、RTOS 移植，都建立在这个基础上。所以这一步，值得你花点时间把它做扎实。