2、STM32开发环境搭建：STM32CubeMX、Keil MDK、HAL库的安装与第一个工程
说实话，很多初学者一上来就急着写代码，结果卡在环境搭建上半天动不了。我见过太多人，下载了错误的包、装了不兼容的版本，最后连个LED都点不亮。
这一章，咱们就把这事彻底捋清楚。你跟着我的节奏走，保证半小时内跑起第一个工程。
2.1 我们需要哪些工具？
做STM32开发，三样东西缺一不可：
- STM32CubeMX：图形化配置工具。说白了，就是帮你生成初始化代码的。不用它？那你得手写寄存器，累死。
- Keil MDK：编译器+调试器。代码写好了，总得有个东西把它变成机器码吧？Keil就是干这个的。
- HAL库：硬件抽象层。STM32官方提供的库函数，让你不用直接操作寄存器。我刚开始做项目时也嫌弃它效率低，后来发现，对于产品开发，可读性和可维护性比那点性能损失重要得多。
核心逻辑：CubeMX生成工程框架 → Keil编写业务代码 → HAL库提供底层驱动。这三者缺一不可。
2.2 安装步骤详解
2.2.1 安装STM32CubeMX
去ST官网下载最新版。注意，需要注册账号，免费的。安装时一路默认就行，没什么坑。
我个人习惯把安装路径改到D盘，免得C盘爆炸。嗯，这个看你自己。
2.2.2 安装Keil MDK
这个稍微麻烦点。去Keil官网下载MDK-ARM版本。安装完成后，记得安装对应芯片的器件包（Pack）。
我曾经有一次忘了装Pack，结果编译报错“找不到芯片定义”，折腾了半小时才发现问题。你想想看，多冤。
避坑指南：Keil的版本和CubeMX的版本要匹配。我建议都用最新版，省事。如果公司有旧项目，那就另说了。
2.2.3 获取HAL库
HAL库其实不用单独安装。CubeMX在生成工程时，会自动把对应的HAL库文件拷贝到你的项目目录里。你只需要在CubeMX里选好芯片型号，它就会帮你搞定。
2.3 第一个工程：点亮LED
好了，工具装完了，咱们来点实际的。我选STM32F103C8T6这块板子，俗称“蓝色妖姬”，淘宝几十块钱一块，非常适合入门。
2.3.1 在CubeMX中配置
- 打开CubeMX，点击“New Project”。
- 在搜索框输入“STM32F103C8”，双击选中。
- 在Pinout视图中，找到PC13引脚（板载LED通常接这个脚），右键设置为GPIO_Output。
- 点击“Project Manager”标签，设置工程名、路径，选择IDE为“MDK-ARM”。
- 点击“GENERATE CODE”，生成工程。
你看，是不是很简单？图形化操作，鼠标点几下就完了。我当年学的时候，还得对着数据手册一个个配寄存器，那叫一个痛苦。
2.3.2 在Keil中编写代码
生成完成后，用Keil打开工程。找到main.c文件，在while(1)循环里加上这几行：
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500);这两行代码什么意思？第一行翻转PC13的电平，第二行延时500毫秒。合起来就是：LED亮500ms，灭500ms，循环往复。
小技巧：HAL_Delay的精度其实不高，做产品时别用它做精确时序。但点个灯、做个按键消抖，完全够用。
2.3.3 编译与下载
点击Keil的“Build”按钮（或者按F7），等编译完成。然后点击“Download”按钮（或者按F8），把程序烧录到板子里。
如果一切顺利，你会看到板子上的LED开始闪烁。那一刻，相信我，你会很有成就感。
2.4 知识体系总览
为了让你对整个流程有个直观的认识，我画了一张图。你看看，是不是一目了然？
2.5 常见问题与解决
我整理了几个新手最容易踩的坑，你看看自己有没有中招：
| 问题现象 | 可能原因 | 解决办法 |
|---|---|---|
| Keil编译报错“找不到芯片” | 没有安装对应的器件包 | 在Keil官网下载对应Pack并安装 |
| 下载时提示“No ST-Link detected” | 驱动没装好或连接线松动 | 重新安装ST-Link驱动，检查接线 |
| LED不亮 | 引脚配置错误或延时太短 | 检查CubeMX中引脚配置，增大延时 |
| CubeMX生成代码后Keil打不开 | 路径包含中文或空格 | 工程路径全部使用英文 |
特别提醒：我曾经因为工程路径里带了个中文“项目”两个字，结果Keil死活打不开。折腾了一下午才发现是路径问题。所以，所有路径都用英文，别偷懒。
2.6 小结
好了，到这一步，你的开发环境已经搭好了，第一个LED程序也跑起来了。别看这只是点个灯，它背后涉及了工具链的完整流程：配置、生成、编译、下载。
这个流程，以后你做任何STM32项目，都得走一遍。所以，现在把它练熟，后面就轻松了。
公众号:蓝海资料掘金营，微信deep3321