第1章：开发环境搭建——工欲善其事，必先利其器
各位同学好，我是老张。做嵌入式开发十几年了，从最早的51单片机一路做到现在的STM32。说实话，每次换开发环境都挺折腾的。但STM32这套工具链，我个人觉得是目前最成熟的之一。今天咱们就把环境搭起来，后面写代码才不慌。
本章核心目标：装好STM32CubeMX、配好Keil MDK、跑通第一个HAL库工程。三件事，一步都不能少。
1.1 为什么选这套工具链？
你可能要问：市面上IDE那么多，为什么非要用STM32CubeMX + Keil MDK？
我简单说三点：
- STM32CubeMX：图形化配置工具，管脚分配、时钟树、外设初始化，全自动生成代码。省去你手写寄存器配置的麻烦。
- Keil MDK：ARM内核的标配IDE，调试功能强大，社区资源丰富。遇到问题百度一下，基本都有答案。
- HAL库：ST官方封装好的硬件抽象层，跨芯片兼容性好。你学会一套API，换芯片也能快速上手。
嗯，说白了就是：CubeMX帮你搭骨架，Keil帮你写血肉，HAL库让你少掉头发。
1.2 STM32CubeMX安装——别踩这些坑
先下载安装包。去ST官网搜"STM32CubeMX"，找到对应版本。我个人建议下载最新稳定版，别追beta版，容易出幺蛾子。
安装步骤：
- 双击安装包，选安装路径。注意：路径不要有中文！我见过有人装到"程序文件"目录下，结果死活打不开。
- 安装过程中会提示安装Java运行环境。CubeMX依赖Java，如果电脑没有，它会自动帮你装。等就行。
- 安装完成后，打开软件。第一次启动会提示更新固件包。点"是"，让它下载。这一步比较慢，建议挂机去喝杯咖啡。
⚠️ 避坑指南：我曾经因为网络问题，固件包下载到一半断了。结果CubeMX一直报错，折腾了半天才发现是包没下完整。建议用有线网络，或者挂个稳定的代理。
1.3 Keil MDK配置——老司机的习惯
Keil MDK安装相对简单。去ARM官网下载MDK-ARM，安装时同样注意路径无中文。
关键配置点：
- 安装器件包：打开Keil，点"Pack Installer"，找到你的芯片型号（比如STM32F103C8），勾选安装。这一步很多人会忘，结果编译时报错找不到芯片定义。
- 注册许可证：Keil需要License才能编译超过32KB的代码。去官网申请一个免费的评估版License，或者用正版授权。别问我怎么破解，我不教这个。
- 配置编译器：我习惯用AC6编译器（ARM Compiler 6），编译速度快，优化效果好。在Project -> Options for Target -> Target 里选择。
💡 我的小技巧：Keil的编辑器默认字体太小，看着费眼。在Edit -> Configuration -> Colors & Fonts 里调大字号。我一般设成14号，舒服多了。
1.4 第一个HAL库工程——点亮LED
环境搭好了，咱们跑个经典的点灯程序。别小看这个，它验证了整个工具链是否通畅。
操作流程：
- 打开STM32CubeMX，新建工程。选芯片型号，比如STM32F103C8。
- 配置时钟：选HSE外部晶振，主频设到72MHz。时钟树配置是新手最容易出错的地方，我后面会专门讲。
- 配置GPIO：选一个引脚（比如PA0）作为输出模式，标签命名为LED。
- 生成代码：Project -> Generate Code。选MDK-ARM V5版本。
- 打开生成的Keil工程，在main.c的while循环里加代码：
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
HAL_Delay(500); // 延时500ms编译下载，你应该能看到LED以1秒的频率闪烁。
为什么能亮？HAL_GPIO_TogglePin这个函数，说白了就是翻转引脚电平。HAL_Delay是HAL库提供的毫秒级延时函数。这两个组合起来，就是最基础的GPIO控制。
1.5 知识体系总览
下面这张图，是我自己画的本章知识结构。你可以把它当成一张地图，后面学习时随时回来对照。
1.6 常见问题与解决
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| CubeMX打不开 | Java环境未安装或版本不对 | 重新安装Java JDK 11以上版本 |
| Keil编译报错"找不到芯片" | 器件包未安装 | 打开Pack Installer安装对应包 |
| 下载程序后LED不亮 | 引脚配置错误或硬件连接问题 | 检查CubeMX引脚分配，确认LED正负极 |
| HAL_Delay卡死 | SysTick中断未使能 | 在CubeMX中确认SysTick配置 |
💡 我的经验：遇到问题先看日志。CubeMX和Keil都会输出详细的编译/下载日志，里面往往藏着答案。别急着百度，先自己读一遍日志，能解决80%的问题。
好了，环境搭建就到这里。你跟着走一遍，应该能跑起来。如果卡住了，回头看看上面的表格，基本都能解决。记住，嵌入式开发就是不断踩坑、填坑的过程。我当年第一个点灯程序折腾了整整一下午，现在回想起来，都是宝贵的经验。