第2章 开发环境搭建：STM32CubeMX安装、Keil MDK配置、GCC工具链选择
说实话，很多初学者在标准库时代最头疼的就是环境配置。那时候你得手动下载固件库、配置启动文件、折腾链接脚本……一个不小心就卡在"点灯"之前。到了HAL库时代，情况好多了，但工具链的选择反而变多了。
我个人习惯把环境搭建分成三个层次：配置工具（CubeMX）、IDE（Keil MDK）、备选工具链（GCC）。今天咱们就把这三块捋清楚。
核心观点：不要试图一步到位。先装CubeMX生成工程，再用Keil验证编译，最后再考虑GCC。这个顺序能帮你快速排除问题。
2.1 STM32CubeMX：HAL开发的"总开关"
STM32CubeMX是ST官方推出的图形化配置工具。它能帮你完成芯片选型、时钟树配置、外设初始化、引脚分配，最后直接生成HAL库工程代码。说白了，你画个配置图，它帮你写初始化代码。
2.1.1 安装步骤
- 下载安装包：去ST官网搜"STM32CubeMX"，下载最新版本（目前是6.x）。需要注册账号，免费。
- 安装Java运行环境：CubeMX基于Java，需要JRE 8或更高版本。我记得有次帮同事装，他电脑上Java版本太旧，CubeMX死活打不开……后来装了JDK 11就好了。
- 安装固件包：打开CubeMX后，点击
Help → Manage embedded software packages，选择你需要的芯片系列（比如STM32F1、F4、H7）。建议只装你实际用的系列，全装的话硬盘会哭。
小技巧：CubeMX的固件包默认下载到C盘。如果你C盘空间紧张，可以在Help → Updater Settings里改路径。我一般放到D盘的一个专用文件夹里。
2.1.2 快速上手：生成一个最小工程
安装完成后，咱们试试生成一个最简单的工程：
- 点击
New Project，选择芯片型号（比如STM32F103C8T6）。 - 在
Pinout & Configuration标签页里，找到SYS，把Debug设为Serial Wire。这一步很多人会忘，导致第一次烧录失败。 - 在
Project Manager标签页里，设置工程名、路径、IDE类型（选MDK-ARM V5）。 - 点击
GENERATE CODE，等几秒，工程就生成了。
嗯，这里要注意：生成的工程里已经包含了HAL库的初始化代码、系统时钟配置、中断向量表。你只需要在main.c的while(1)里写业务逻辑就行。
2.2 Keil MDK：最主流的ARM开发IDE
Keil MDK（Microcontroller Development Kit）是ARM公司推出的IDE，也是国内STM32开发者用得最多的工具。它集成了编辑器、编译器、调试器，开箱即用。
2.2.1 安装与破解（正版用户请忽略破解部分）
- 下载安装包：去Keil官网下载MDK-ARM最新版（目前是5.38）。安装过程一路Next就行。
- 安装器件包：打开Keil，点击
Pack Installer，找到你用的芯片系列（比如STM32F1xx_DFP），点击Install。这一步是让Keil认识你的芯片。 - 注册（破解）：如果你用的是评估版，需要注册。运行Keil，点击
File → License Management，用注册机生成序列号。我曾经见过有人因为注册失败，编译时提示"代码大小限制"……其实换个序列号就行。
避坑指南：Keil MDK 5.x版本对中文路径支持不好。工程路径、源文件路径里不要出现中文、空格、特殊符号。我曾经因为把工程放在"桌面/我的项目"里，编译报了一堆莫名其妙的错误……后来改成"D:\Project\STM32\LED"就没事了。
2.2.2 配置CubeMX生成的工程
用CubeMX生成工程后，双击.uvprojx文件就能用Keil打开。但有几个地方需要手动检查：
| 配置项 | 推荐设置 | 说明 |
|---|---|---|
| Target → ARM Compiler | Use default compiler version 6 | V6编译器比V5快，代码密度更好 |
| C/C++ → Optimization | 调试阶段选 -O0，发布阶段选 -Os | -O0编译快，-Os优化代码大小 |
| Debug → Use | 选择你的调试器（ST-Link/J-Link） | ST-Link最常见，J-Link更稳定 |
| Utilities → Settings | 勾选"Reset and Run" | 烧录后自动复位运行，省一次手动复位 |
我个人习惯在调试阶段把优化等级设为-O0，这样单步调试时变量值不会"优化掉"。等代码稳定了再改成-Os。
2.3 GCC工具链：开源玩家的选择
如果你不想用Keil（或者买不起正版），GCC工具链是个很好的替代方案。ARM GCC（GNU Arm Embedded Toolchain）是免费的，而且跨平台（Windows/Linux/Mac都能用）。
2.3.1 安装ARM GCC
- 下载：去ARM官网搜"GNU Arm Embedded Toolchain"，下载最新版。Windows用户选
.exe安装包。 - 安装：一路Next，注意勾选"Add path to environment variable"。这样你就能在命令行里直接敲
arm-none-eabi-gcc了。 - 验证：打开命令行，输入
arm-none-eabi-gcc --version，看到版本号就说明装好了。
小技巧：如果你用VS Code写代码，可以装Cortex-Debug插件配合GCC使用。调试体验不输Keil，而且免费。
2.3.2 用GCC编译CubeMX工程
CubeMX生成的工程默认是Keil格式。如果想用GCC编译，需要在CubeMX里做两件事：
- 在
Project Manager → Project里，把Toolchain / IDE改成Makefile。 - 重新生成代码。CubeMX会生成一个
Makefile，里面已经写好了编译规则。
然后在工程目录下打开命令行，敲make，就能编译了。生成的.hex或.bin文件可以用ST-Link Utility或OpenOCD烧录。
避坑指南：GCC的链接脚本（.ld文件）和Keil的不一样。如果你自己写链接脚本，注意检查_estack（栈顶地址）和_Min_Heap_Size（最小堆大小）这两个符号。我见过有人把栈顶设错了，程序跑起来就进HardFault……
2.4 三种工具链对比
你可能会问：到底该用哪个？我整理了一个对比表：
| 特性 | Keil MDK | GCC + Makefile | IAR EWARM |
|---|---|---|---|
| 上手难度 | 低（图形化） | 中（需要懂Makefile） | 低（图形化） |
| 编译速度 | 快（ARM Compiler V6） | 中等 | 快 |
| 代码密度 | 优秀 | 良好 | 优秀 |
| 调试体验 | 好（集成调试器） | 中等（需配合VS Code） | 好 |
| 价格 | 收费（约2万RMB） | 免费 | 收费（约3万RMB） |
| 跨平台 | 仅Windows | Windows/Linux/Mac | Windows/Linux |
我个人建议：初学者先用Keil，等熟悉了HAL库的套路，再尝试GCC。如果你做产品开发，公司买了Keil正版，那就用Keil，省心。如果你做开源项目或者个人学习，GCC完全够用。
2.5 知识体系总览
下面这张图帮你理清本章的知识结构：
2.6 常见问题与解决方案
最后，分享几个我在项目中遇到过的实际问题：
- CubeMX生成的工程编译报错"找不到头文件"：检查Keil的
C/C++ → Include Paths，确保包含了Drivers/STM32F1xx_HAL_Driver/Inc和Inc这两个路径。CubeMX有时候会漏掉。 - 烧录后程序不运行：检查
SystemInit()函数是否被调用。如果用的是HAL库，确保HAL_Init()在main()开头执行。 - GCC编译报错"undefined reference to _exit"：这是GCC的syscalls问题。需要在工程里添加
syscalls.c文件，或者用--specs=nano.specs --specs=nosys.specs链接选项。