2. 开发环境搭建：STM32CubeMX的安装与配置、MDK-ARM/IAR IDE的工程建立、调试器配置
做嵌入式开发，第一件事就是把家伙事儿备齐。我记得刚入行那会儿，光装个IDE就折腾了一整天，各种版本不兼容、驱动装不上、调试器连不通……嗯，今天咱们就把这些坑提前填上。
2.1 STM32CubeMX：从图形化配置到代码生成
STM32CubeMX是ST官方推出的图形化配置工具。说白了，它帮你省去了手动写初始化代码的苦力活。你点点鼠标，它就能生成完整的HAL库工程。
2.1.1 安装步骤
- 下载安装包：去ST官网搜"STM32CubeMX"，下载最新版本。需要注册账号，免费。
- 安装Java运行环境：CubeMX基于Java，需要JRE 8或更高版本。我个人习惯装OpenJDK，省心。
- 运行安装程序：一路Next就行。注意安装路径不要有中文和空格。
- 安装固件包：打开CubeMX，点击Help → Manage embedded software packages，选择你需要的STM32系列（比如STM32F4、STM32H7），下载对应的固件包。
2.1.2 工程配置流程
打开CubeMX，新建工程，选择芯片型号。我一般直接搜型号，比如"STM32F407VGT6"。然后进入Pinout & Configuration界面，配置时钟、外设、中断等。
| 配置项 | 说明 | 个人建议 |
|---|---|---|
| RCC（时钟） | 选择HSE（外部高速晶振） | 别用内部RC，精度不够 |
| Clock Configuration | 配置系统时钟树 | 先点"HCLK"输入目标频率，让工具自动算 |
| GPIO | 配置引脚功能 | 注意复用功能映射，别跟其他外设冲突 |
| NVIC | 中断优先级分组 | 建议用4位抢占优先级，够用 |
配置完成后，点击Project → Generate Code。这里要注意：
- Toolchain / IDE：选择MDK-ARM或IAR，后面会讲。
- Generate Under Root：勾上，让CubeMX在工程目录下生成代码。
- Copy only the necessary library files：建议勾选，减少工程体积。
2.2 MDK-ARM（Keil）工程建立与配置
MDK-ARM是ARM公司推出的IDE，国内用得最多。我个人觉得它的调试界面比IAR直观，但编译速度慢一些。
2.2.1 安装MDK-ARM
- 下载MDK-ARM安装包（建议用5.38或更高版本）。
- 安装时选择默认路径，注意勾选Support for Cortex-M。
- 安装完成后，打开Pack Installer，下载对应芯片的Device Family Pack（比如STM32F4的DFP）。
2.2.2 导入CubeMX生成的工程
CubeMX生成代码时，如果选择了MDK-ARM，会生成一个.uvprojx文件。直接双击打开就行。但有几个地方需要手动检查：
- Target Options → Target：确认ARM Compiler版本，建议用V6（AC6），编译优化更好。
- Target Options → C/C++：勾选C99 Mode，有些HAL库代码依赖C99。
- Target Options → Debug：选择调试器（后面讲）。
2.2.3 编译与下载
按F7编译，如果没报错，按F8下载。我第一次用MDK时，编译报了一堆错，后来发现是编译器版本没选对。嗯，这里要注意：AC5和AC6的语法检查严格程度不一样，AC6更严格。
2.3 IAR Embedded Workbench：另一种选择
IAR的编译优化比MDK好，代码密度更小。我在做量产项目时更倾向用IAR，尤其是Flash空间紧张的时候。
2.3.1 安装IAR
- 下载IAR for ARM安装包（建议用8.50或更高版本）。
- 安装时选择Full Installation，包含所有器件支持。
- 安装完成后，打开IAR License Manager，激活许可证。
2.3.2 导入CubeMX生成的工程
CubeMX生成IAR工程时，会生成一个.eww文件。打开方式：
- 直接双击.eww文件。
- 或者先打开IAR IDE，然后File → Open Workspace。
导入后，建议检查以下配置：
| 配置项 | 位置 | 建议值 |
|---|---|---|
| 优化等级 | Project → Options → C/C++ Compiler → Optimizations | 调试阶段用None，发布用High |
| 链接器配置 | Project → Options → Linker | 确认Flash和RAM地址正确 |
| 调试器 | Project → Options → Debugger | 选择对应的调试器驱动 |
2.4 调试器配置：J-Link、ST-Link、DAP-Link
调试器是连接PC和目标板的桥梁。三种主流调试器，我挨个说。
2.4.1 ST-Link（最常用）
STM32开发板基本都板载ST-Link。配置步骤：
- 安装ST-Link驱动（ST官网下载ST-Link USB driver）。
- 用USB线连接开发板和电脑。
- 在IDE中配置调试器为ST-Link。
MDK中的配置：Target Options → Debug → Use: ST-Link Debugger → Settings，选择SWD模式，速度建议4MHz。
IAR中的配置：Project → Options → Debugger → Setup → Driver: ST-Link，然后在ST-Link选项卡里选择SWD。
2.4.2 J-Link（专业调试）
J-Link调试功能强大，支持RTT、实时跟踪等。配置步骤类似：
- 安装J-Link Software and Documentation Pack。
- IDE中调试器选择J-Link / J-Trace。
- 连接方式选SWD，速度可以设到10MHz以上。
2.4.3 DAP-Link（开源方案）
DAP-Link是ARM官方的开源调试器，很多国产开发板在用。驱动是免驱的，但需要安装CMSIS-DAP驱动包。
2.5 知识体系总览
下面这张图把本章的核心流程串起来了。你想想看，从CubeMX配置到IDE编译，再到调试器连接，每一步都环环相扣。
2.6 常见问题与避坑指南
原因：编译器版本不匹配，或者HAL库版本太旧。
解决：在CubeMX的Project Manager → Project中，选择最新的HAL库版本。如果还不行，手动更新MDK或IAR的Device Pack。
排查步骤：
1. 检查接线：SWDIO、SWCLK、GND、VCC（可选）。
2. 检查目标板供电：调试器不供电，需要目标板自己上电。
3. 检查复位电路：有些板子需要手动复位才能连接。
4. 降低SWD速度：从4MHz降到1MHz试试。
我曾经遇到过：下载成功，但程序不跑。后来发现是启动文件里的堆栈大小设置不对。在CubeMX的Project Manager → Advanced Settings里，把Heap和Stack设大一点，比如0x400和0x800。