第2章 开发环境搭建：STM32CubeMX安装、TouchGFX Designer安装、IDE配置
说实话，很多初学者一上来就急着写代码，结果卡在环境搭建上大半天。我当年第一次搞TouchGFX移植时，光装软件就折腾了两天——版本不匹配、路径带中文、驱动没装全……各种坑踩了个遍。这一章咱们就把这些基础工作捋清楚，后面才能安心写代码。
本章核心目标：装好三件套——STM32CubeMX（芯片配置）、TouchGFX Designer（界面设计）、IDE（编译下载）。版本之间要能互相认，路径不能有中文，驱动必须到位。
2.1 工具链全景图
先看一张整体关系图，你心里就有数了：
说白了，这三者就是一条流水线：CubeMX负责硬件配置，TouchGFX Designer负责界面设计，IDE负责把代码变成能跑的程序。缺一个环节，你的界面就出不来。
2.2 STM32CubeMX 安装
这个工具是ST官方的芯片配置神器。我习惯叫它「硬件初始化生成器」——你点点鼠标，它就把时钟树、GPIO、DMA、FMC这些配置代码全给你生成了。
2.2.1 下载与安装步骤
- 去ST官网下载：搜索"STM32CubeMX"，找到最新版本。注意区分Windows/Linux/Mac版本。
- 安装路径不能有中文：我见过有人装在"D:\软件\STM32CubeMX"这种路径，结果后面生成代码时各种报错。老老实实装在纯英文路径下。
- Java环境检查：CubeMX依赖Java运行环境。如果电脑没装JRE，安装程序会提示你下载。建议装Java 11以上版本。
- 安装完成后：双击桌面图标，能正常打开就说明装好了。
⚠ 我曾经踩过的坑：安装时选了默认路径"C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeMX"，结果后面因为权限问题，生成的项目文件写不进去。后来我改到"D:\ST\STM32CubeMX"才解决。建议装到非系统盘的非中文目录。
2.2.2 首次启动配置
打开CubeMX后，先做两件事：
- 更新固件包：点击Help → Manage embedded software packages，把你要用的芯片系列（比如STM32F4、STM32H7）的固件包下载下来。这一步很关键，没有固件包你后面选不了芯片。
- 设置工程模板路径：File → Settings → Project，把默认路径改到你自己的工作目录。我习惯用"D:\Projects\TouchGFX\"。
2.3 TouchGFX Designer 安装
这个工具是TouchGFX的UI设计器。你拖拽控件、设置颜色、绑定事件，它自动生成C++代码。说白了，你不需要手写界面代码——但前提是你得把环境配对。
2.3.1 版本选择
TouchGFX Designer的版本必须和CubeMX的版本匹配。我整理了一个对照表：
| CubeMX版本 | TouchGFX Designer版本 | 备注 |
|---|---|---|
| 6.8.x | 4.21.x | 当前最稳定组合 |
| 6.7.x | 4.20.x | 也可用，但部分新功能不支持 |
| 6.5.x | 4.18.x | 老项目还在用，不推荐新项目 |
💡 我的建议：别追最新版。我试过CubeMX 6.9 + TouchGFX 4.22，结果生成代码时接口变了，折腾了两天。目前用6.8 + 4.21最稳。
2.3.2 安装步骤
- 从ST官网下载：搜索"TouchGFX Designer"，注意区分版本。下载时选"TouchGFX Designer for STM32"那个。
- 安装路径同样不能有中文：我装在了"D:\ST\TouchGFX\4.21.0"。
- 安装过程中：它会自动检测电脑上有没有CubeMX。如果没检测到，会提示你手动指定路径。别跳过这一步，否则后面两个工具没法联动。
- 安装完成后：打开TouchGFX Designer，能看到欢迎界面就说明装好了。
2.4 IDE 配置（Keil / IAR / STM32CubeIDE）
IDE的选择看个人习惯。我三个都用过，说说我的感受：
- Keil：老牌工具，生态成熟，调试方便。但收费，而且对ARM Compiler 6的支持有点坑。
- IAR：编译优化好，代码密度高。但界面丑，而且License管理麻烦。
- STM32CubeIDE：免费，基于Eclipse，和CubeMX集成度高。但启动慢，插件多了容易卡。
我个人推荐新手用STM32CubeIDE，因为免费且和CubeMX无缝对接。但如果你公司统一用Keil，那也没问题——后面我会讲怎么在Keil里配置TouchGFX。
2.4.1 Keil 配置要点
- 安装Keil MDK：版本建议5.36以上。注意安装时选对芯片包（比如STM32F4xx_DFP）。
- 配置编译器：Project → Options for Target → C/C++，把编译器选为"ARM Compiler 6"。TouchGFX生成的代码对AC6支持更好。
- 添加TouchGFX库路径：在C/C++的Include Paths里，加上TouchGFX的HAL层路径。具体路径后面章节会细讲。
- 设置堆栈大小：TouchGFX界面需要较大的堆空间。我一般把Heap设为0x2000（8KB），Stack设为0x1000（4KB）。
⚠ 我曾经踩过的坑：用Keil AC5编译器编译TouchGFX项目，结果报了一堆"undefined reference"错误。后来换成AC6就好了。如果你非要用AC5，得手动改很多链接脚本——别自找麻烦。
2.4.2 STM32CubeIDE 配置要点
- 下载安装：从ST官网下载最新版。安装时选"STM32CubeIDE for STM32"。
- 导入CubeMX项目：File → Import → STM32CubeMX Project，选择之前生成的.ioc文件。IDE会自动识别配置。
- 配置编译链：Project → Properties → C/C++ Build → Settings，确认Toolchain选的是"STM32CubeIDE GCC"。
- 添加TouchGFX组件：在CubeMX里勾选TouchGFX组件后，IDE会自动添加相关库。如果没自动加，手动在Properties里添加TouchGFX的lib路径。
2.5 环境验证：跑一个最小工程
装完所有工具后，我建议你跑一个最小工程验证一下。别等到写了几百行代码才发现环境有问题。
2.5.1 验证步骤
- 打开CubeMX，新建一个工程，选你手头的开发板型号（比如STM32F429I-DISC1）。
- 配置时钟：把HCLK设为168MHz（F4系列典型值）。
- 勾选TouchGFX组件：在Pinout & Configuration → Software Packs → TouchGFX里勾选"Enabled"。
- 生成代码：Project → Generate Code。注意选对IDE类型（Keil/IAR/STM32CubeIDE）。
- 打开IDE，编译工程。如果零错误零警告，说明环境没问题。
- 下载到开发板：接上ST-Link，点击下载。如果屏幕亮了（或者串口有输出），恭喜你——环境搭建成功。
💡 一个小技巧：第一次编译TouchGFX工程时，编译时间会比较长（尤其是H7系列）。别急，去泡杯咖啡。后面增量编译就快了。
2.6 常见问题与避坑指南
我整理了几个新手最容易遇到的问题，你遇到了直接对照着查：
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| CubeMX打不开 | Java版本不对 | 安装Java 11+，并配置JAVA_HOME环境变量 |
| TouchGFX Designer无法启动 | 缺少VC++运行库 | 安装Visual C++ Redistributable 2015-2022 |
| 编译报"undefined reference" | TouchGFX库路径没加 | 在IDE里添加TouchGFX的lib和include路径 |
| 下载后屏幕不亮 | LTDC/DSI配置错误 | 检查CubeMX中显示接口的引脚配置 |
| 编译报内存不足 | 堆栈设置太小 | 增大Heap和Stack大小，或优化代码 |
嗯，环境搭建这块就这些内容。你按照上面的步骤走一遍，应该半小时内就能搞定。如果卡住了，回头看看表格里的常见问题——大部分坑我都替你踩过了。