4、STM32CubeIDE环境搭建：安装、项目创建与图形化配置

说实话，STM32CubeIDE 刚出来那会儿，我还有点抵触。毕竟之前用惯了 Keil 和 IAR，突然换个新工具总觉得麻烦。但后来被项目逼着用了一次——嗯，真香。它把 CubeMX 的图形化配置和 IDE 的开发调试集成到了一起，省去了来回倒腾的功夫。这一章，我就带你走一遍完整的流程。

4.1 安装 STM32CubeIDE

安装本身没什么难度，但有几个坑我得提前跟你说。

1. 下载安装包：访问 st.com/stm32cubeide，找到对应版本。文件大概 1GB 左右，网速慢的话可以泡杯咖啡。
2. 运行安装程序：Windows 下双击 .exe，一路 Next 就行。安装路径建议用默认的，别放中文目录——我吃过这个亏，中文路径导致某些插件加载失败。
3. 选择组件：安装过程中会让你选要不要装驱动。我个人建议全选，尤其是 ST-Link 驱动，后面烧录全靠它。
4. 完成安装：装完后第一次启动会初始化工作空间（workspace）。选个你习惯的目录，比如 D:\STM32Workspace，别放 C 盘，你懂的。

4.2 创建第一个项目

装好了，咱们来建个项目试试手。打开 CubeIDE，你会看到一个欢迎界面。别慌，直接点 File → New → STM32 Project。

4.2.1 选择芯片型号

这一步很关键。你得知道自己手头用的是哪颗芯片。比如我常用的 STM32F103C8T6，就在搜索框里输入 STM32F103C8，然后从列表里选中。

4.2.2 项目命名与初始化

选好芯片后，给项目起个名字。我习惯用 项目名_芯片型号 的格式，比如 LED_Blink_F103。然后选 Empty 作为项目模板——别选那些带例程的，容易乱。

点 Finish 后，IDE 会自动生成项目结构。你会看到左侧多了一堆文件夹：Core、Drivers、Inc 等等。别被吓到，这是 CubeIDE 帮你搭好的骨架。

4.3 CubeMX 图形化配置

这才是 CubeIDE 的杀手锏。双击项目里的 .ioc 文件，就会打开 CubeMX 配置界面。说白了，这就是个可视化引脚和外设配置工具，你点点鼠标就能生成初始化代码。

4.3.1 配置时钟树

时钟配置是嵌入式开发的起点。我见过不少新手上来就写代码，结果外设不工作，最后发现是时钟没配好。

在 CubeMX 里，点 Clock Configuration 标签页。你会看到一个时钟树图。以 STM32F103 为例：

• HSE：外部高速晶振，一般用 8MHz。在 RCC 里把 HSE 设为 Crystal/Ceramic Resonator。
• PLL：锁相环，用来倍频。我一般把 HSE 倍频到 72MHz——这是 F103 的最高主频。
• SYSCLK：系统时钟，选 PLLCLK 作为来源。

配好后，时钟树上的数字会变绿，表示配置有效。如果变红，说明某个分频系数不对，调整一下就行。

4.3.2 配置 GPIO

咱们拿点灯来练手。在 Pinout & Configuration 标签页里，找到你要用的 GPIO 引脚。比如 PA5，点击它，选择 GPIO_Output。

然后在右侧的 GPIO 设置里：

• Output Level：初始电平，选 Low 或 High 都行。
• Mode：推挽输出（Push-Pull），这是最常用的。
• Speed：建议选 High，尤其是你要做 PWM 或高速通信时。

配完后，你会看到引脚上多了个绿色的标签，表示已配置。

4.3.3 配置串口（USART）

串口是调试利器。我几乎每个项目都会配一个串口，用来打印日志。在 Connectivity 里找到 USART1，打开它：

• Mode：选 Asynchronous（异步模式）。
• Baud Rate：115200，这是最常用的波特率。
• Word Length：8 Bits。
• Parity：None。
• Stop Bits：1。

配好后，CubeMX 会自动把 TX 和 RX 引脚分配到对应的 GPIO 上。你可以在 Pinout View 里确认一下。

4.4 代码生成

配置完了，该让 CubeMX 帮我们写代码了。点右上角的 Generate Code 按钮，或者按 Ctrl+S 保存 .ioc 文件，代码就会自动生成。

4.4.1 生成的代码结构

生成完成后，回到 IDE，你会看到 Core/Src 目录下多了几个文件：

你可能会问：为什么代码要分这么多文件？说白了，这是 HAL 库的设计哲学——把硬件抽象层和用户代码分开，方便移植和维护。

4.4.2 编写用户代码

打开 main.c，找到 int main(void) 函数。你会看到 CubeMX 已经帮你生成了初始化代码：

int main(void)
{
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_USART1_UART_Init();

  while (1)
  {
    // 你的代码写在这里
  }
}

现在，咱们加点灯的逻辑。在 while(1) 里加上：

HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
HAL_Delay(500);

这段代码会让 PA5 上的 LED 每隔 500ms 翻转一次。编译下载后，你就能看到灯在闪了。

4.5 知识体系总览

为了让你对整个流程有个全局认识，我画了张图。你可以把它当作本章的路线图：

4.6 避坑指南

最后，分享几个我踩过的坑，希望能帮你省点时间。

• 生成代码后编译报错：检查一下是不是忘了选芯片型号。我遇到过有人选了 STM32F103C8，但实际用的是 STM32F103RB，外设地址对不上，编译当然过不了。
• 串口打印乱码：八成是波特率没对上。检查 CubeMX 里配的波特率和串口助手里设置的是不是一致。另外，别忘了检查时钟配置——HSE 频率不对，波特率也会偏。
• LED 不亮：先确认引脚是不是对的。我犯过最蠢的错误是，在代码里操作 PA5，但板子上的 LED 接的是 PB0。用万用表量一下引脚电平，比瞎猜快得多。
• 重新生成代码后，之前的修改没了：记住，用户代码要写在 /* USER CODE BEGIN */ 和 /* USER CODE END */ 之间。CubeMX 只会保留这两个注释块里的内容，外面的代码会被覆盖。