3. 开发环境搭建
说实话，很多初学者一上来就急着写代码，结果卡在环境搭建上大半天。我见过太多人，代码逻辑没问题，就是编译不过、下载不了，最后发现是工具链没配好。这一章，咱们就把这些基础工作一次性搞定。
本章核心目标：让你的电脑能编译、能下载、能调试STM32程序。说白了，就是给嵌入式开发搭好“灶台”。
3.1 知识体系总览
在动手之前，我们先看看这三样工具各自扮演什么角色。我习惯用一张图来理解它们的关系：
嗯，这张图很直观。你想想看，CubeMX负责“画图纸”，Keil负责“施工”，仿真器就是“施工队和工地的连接线”。缺了任何一个，活儿都干不成。
3.2 Keil MDK的安装与配置
Keil MDK，全称Microcontroller Development Kit。我个人习惯叫它“Keil”，因为顺口。它是ARM内核单片机开发的主流IDE，没有之一。
3.2.1 下载与安装
去ARM官网或者Keil官网下载MDK-ARM安装包。注意版本，我建议用5.38或更新的版本，太老的版本对新型号支持不好。
- 双击安装包，一路Next。安装路径不要有中文，切记。
- 选择组件：默认全选就行。如果你硬盘空间紧张，可以取消“CMSIS”和“Device”以外的文档包。
- 等待安装完成。这个过程大概5-10分钟，取决于你的电脑。
注意：安装路径不要有空格和中文！我曾经在一个项目里，同事把Keil装在了“Program Files (x86)”里，结果编译某些老工程时路径解析出错，折腾了半天才发现是空格惹的祸。
3.2.2 注册与激活
Keil MDK是收费软件，但提供了评估版（代码限制32KB）。对于学习来说，32KB完全够用。如果你需要解锁全部功能，需要购买License。
激活步骤很简单：
- 打开Keil，点击 File → License Management
- 复制CID码，发给你的License供应商
- 拿到激活码后，粘贴进去，点击Add LIC
小技巧：如果你只是学习，用评估版就行。32KB的Flash空间，写个LED闪烁、串口通信、甚至简单的RTOS都绰绰有余。我当年学STM32时，就是用评估版跑完了所有基础实验。
3.2.3 配置编译器与调试器
安装完Keil后，第一件事不是写代码，而是配置工具链。打开Keil，点击 Project → Options for Target，你会看到几个关键选项卡：
| 选项卡 | 关键设置 | 说明 |
|---|---|---|
| Device | 选择你的芯片型号 | 比如STM32F103C8T6 |
| Target | ARM Compiler版本 | 推荐V6或V5，V6编译更快 |
| Output | 勾选“Create HEX File” | 生成烧录文件 |
| Debug | 选择仿真器类型 | ST-Link / J-Link / DAP-Link |
这里有个坑：ARM Compiler V6 对代码的语法检查更严格。如果你从老工程迁移代码，可能会报一堆警告。我建议新工程直接用V6，老工程保持V5不动。
3.3 STM32CubeMX的安装与使用
STM32CubeMX是ST官方出的图形化配置工具。说白了，就是帮你省掉手动配置寄存器的时间。你点点鼠标，它就能生成初始化代码。
3.3.1 安装步骤
去ST官网下载STM32CubeMX，需要注册账号。安装过程很简单：
- 解压安装包，运行Setup.exe
- 选择安装路径（同样不要中文）
- 安装Java运行环境（CubeMX基于Java，会自动提示）
重要：CubeMX需要Java 8或更高版本。如果你电脑上没有，安装程序会引导你下载。别跳过这一步，否则打不开。
3.3.2 基本使用流程
我第一次用CubeMX时，感觉就像在玩拼图。流程其实很固定：
- 新建工程：选择芯片型号，比如STM32F103C8
- 配置引脚：在芯片图上点击引脚，分配功能（GPIO、USART、SPI等）
- 配置时钟：在Clock Configuration页面，设置系统时钟频率。我习惯先选HSE外部晶振，再配置PLL倍频
- 配置外设：比如USART的波特率、GPIO的推挽输出等
- 生成代码：点击Project Manager，设置工程名、路径、IDE类型（选MDK-ARM V5）
- 点击GENERATE CODE：等待几秒，代码就生成了
经验之谈：生成代码后，不要手动修改CubeMX生成的初始化函数。如果你需要改配置，回到CubeMX里改，再重新生成。我曾经手欠改了HAL_Init()，结果下次重新生成时全被覆盖了，白忙活一场。
3.3.3 与Keil的配合
CubeMX生成的工程，直接用Keil打开。路径在：你的工程目录/MDK-ARM/工程名.uvprojx。双击就能打开，直接编译下载。
嗯，这里要注意：每次用CubeMX重新生成代码后，Keil工程会自动更新。但如果你在Keil里手动添加了.c文件，重新生成时可能会丢失。我的做法是：把自定义代码写在 /* USER CODE BEGIN */ 和 /* USER CODE END */ 之间，这样CubeMX就不会动它们。
3.4 仿真器驱动安装
仿真器，就是连接电脑和开发板的桥梁。最常见的三种：ST-Link、J-Link、DAP-Link。咱们以ST-Link为例，因为STM32开发板基本都自带它。
3.4.1 ST-Link驱动安装
ST-Link驱动通常集成在Keil安装包里。如果你安装Keil时勾选了“ST-Link”组件，驱动就已经装好了。验证方法：
- 插上开发板，打开设备管理器
- 看“通用串行总线设备”里有没有“STMicroelectronics STLink dongle”
- 如果有，说明驱动正常。如果显示黄色感叹号，需要手动安装
手动安装也很简单：去ST官网下载“ST-Link USB driver”，或者用Keil安装目录下的 ARM/STLink/USBDriver 里的驱动包。
避坑指南：我曾经遇到一个情况，ST-Link驱动装好了，但Keil里死活识别不到。折腾了半天，发现是USB线的问题——那根线只能充电，不能传数据。换了一根带数据功能的USB线，立马好了。所以，别小看USB线，它可能是你调试路上最大的绊脚石。
3.4.2 J-Link驱动安装
如果你用J-Link仿真器，需要安装SEGGER官方驱动。去SEGGER官网下载“J-Link Software and Documentation Pack”。安装后，J-Link驱动会自动集成到Keil里。
配置方法：在Keil的Options for Target → Debug选项卡里，把调试器从“ST-Link Debugger”改成“J-Link/J-Trace Cortex”。
3.4.3 驱动验证
驱动装没装好，最直接的办法就是点一下Keil里的“Download”按钮。如果能成功烧录程序，说明一切正常。如果报错，按这个顺序排查：
- 检查USB线是否支持数据传输
- 检查设备管理器里驱动是否正常
- 检查Keil的Debug配置是否正确
- 检查开发板供电是否正常
总结一下：环境搭建其实就三步——装Keil、装CubeMX、装驱动。每一步都有坑，但踩过一次就记住了。我当年第一次搭环境，从下午搞到晚上十点，最后发现是USB线的问题。从那以后，我抽屉里常备三根好用的USB线。
好了，工具都装好了。下一件事，就是打开Keil，新建一个工程，点亮你的第一颗LED。不过那是后面章节的事了，咱们先把基础打牢。