📚 课程目录第4章 GPIO与基础外设开发

4. GPIO与基础外设开发

说实话，很多初学者在学STM32时，第一步就被开发环境卡住了。我记得自己最早用Keil，后来换IAR，再后来ST官方出了CubeIDE。现在回过头看，CubeIDE确实是最省心的选择——免费、集成CubeMX、调试器直接嵌在里边，一套搞定。

这一章，我就带你从头走一遍。从安装到建工程，再到编译、下载、调试，每一步我都会把实际项目中踩过的坑指出来。

先去ST官网下载最新版CubeIDE。注意区分操作系统版本，Windows、Linux、macOS都有。我个人习惯用Windows，但Linux下做产品级开发也很稳。

安装小提示： 安装路径不要带中文，不要有空格。我见过有人装在“Program Files (x86)”下，结果驱动死活装不上。老老实实放根目录，比如 C:\ST\STM32CubeIDE。

安装过程中，ST会提示你安装驱动。一定要点“安装”，否则后面调试器连不上。嗯，这里要注意：如果之前装过其他版本的ST-Link驱动，最好先卸载干净，否则会有冲突。

第一次启动CubeIDE，它会让你选工作空间（Workspace）。说白了，这就是你所有项目的存放目录。

注意： 工作空间里不要放太多项目。CubeIDE每次启动会扫描整个Workspace，项目多了启动会变慢。我一般控制在10个以内。

接下来就是创建项目了。CubeIDE的工程向导其实就是把CubeMX嵌进来了。你选芯片型号、配置时钟、外设，它自动生成初始化代码。

操作步骤很简单：

这里有个关键点：生成代码时，CubeIDE会问你“是否打开Device Configuration Tool？”。我建议选“是”，这样后面改外设配置可以直接在图形界面里改，不用手写寄存器。

  核心经验： 第一次生成代码后，先编译一次，确保环境没问题。不要急着写业务逻辑。我见过太多人一上来就写代码，结果发现编译器报错，又回头查环境，浪费时间。

代码生成后，你会看到CubeIDE自动生成了这些文件：

文件/文件夹	说明
`Core/Inc`	头文件目录，放 `main.h`、`stm32f1xx_hal_conf.h` 等
`Core/Src`	源文件目录，放 `main.c`、`stm32f1xx_hal_msp.c` 等
`Drivers`	HAL库和CMSIS驱动文件
`.ioc` 文件	CubeMX的配置文件，双击可打开图形配置界面

编译很简单，点工具栏上的锤子图标，或者按 Ctrl+B。第一次编译会慢一些，因为要编译整个HAL库。后面只改你自己的代码，编译就快了。

编译加速技巧： 在项目属性里，把 Optimization 设为 -O0（调试阶段），不要开 -Os 或 -O2。开优化后，调试时变量可能被优化掉，你看不到值。我踩过这个坑，查bug查了一下午。

编译通过后，就该下载调试了。CubeIDE的调试视图非常强大，我简单说几个最常用的功能。

点工具栏上的绿色虫子图标（Debug），或者按 F11。第一次调试会弹出调试配置窗口，一般默认就行。注意选对调试器（ST-Link、J-Link等）。

进入调试模式后，界面会变成调试布局。主要区域有：

调试注意事项： 调试时不要拔掉ST-Link的USB线，否则调试器会断开。另外，如果程序跑飞了（比如进入HardFault），先看调用栈，找到最后调用的函数，多半是数组越界或指针错误。

下面这张图把整个开发环境搭建的流程串起来了。你跟着走一遍，基本就不会出大问题。

你看，整个流程其实就五步。安装、设工作空间、建项目、编译、调试。每一步都有坑，但只要你按上面的步骤来，基本一次过。

我记得第一次用CubeIDE时，卡在驱动安装上。后来发现是之前装过旧版ST-Link驱动，卸载干净重装就好了。所以，如果你遇到类似问题，先检查驱动。

好了，这一章的内容就这些。环境搭好了，后面就可以真正开始写代码了。你先把环境跑通，有问题随时翻回来看。