第2章嵌入式开发环境搭建

第2章嵌入式开发环境搭建：STM32CubeIDE安装、工程模板创建、调试器配置

好，咱们直接进入正题。做嵌入式开发，第一件事就是把家伙事儿备齐。STM32CubeIDE 是 ST 官方推出的免费 IDE，基于 Eclipse 魔改而来。说实话，我早年用 Keil 和 IAR 比较多，但自从 ST 把 CubeMX 和 IDE 整合到一起后，我就彻底转投了。原因很简单——省事。

这一章，我会带你走一遍完整的搭建流程。从安装、建工程，到连上调试器跑通第一个点灯程序。嗯，每一步我都会穿插一些我踩过的坑，你跟着走，能少走不少弯路。

2.1 STM32CubeIDE 的安装与版本选择

先说说版本。我个人习惯是：不要追最新版。ST 大概每季度发一个大版本，有时候新版本会引入一些奇怪的 bug。我建议你选一个稳定版，比如 1.13.x 或 1.14.x 系列。你可以在 ST 官网的「STM32CubeIDE」页面找到历史版本存档。

注意：安装路径不要带中文，不要带空格。我见过有人装在「D:\软件\STM32CubeIDE」下面，结果编译时路径解析出问题。老老实实用英文路径。

安装过程很简单，双击 exe，一路 Next。但有两个地方要留意：

驱动选择：安装过程中会提示是否安装 ST-Link 驱动。一定要勾上。否则你连调试器都认不出来。
组件选择：默认会安装所有支持的 MCU 系列包。如果你硬盘空间紧张，可以只勾你需要的，比如 STM32F4、STM32G0 系列。我一般全装，省得后面再补。

安装完成后，第一次启动会提示选择工作空间（Workspace）。我建议单独建一个文件夹，比如 D:\STM32_Workspace。别用默认的，因为默认路径通常藏在用户目录下，找起来麻烦。

2.2 创建你的第一个工程模板

工程模板这东西，说白了就是「搭骨架」。我每次做新项目，都会从一个干净的模板开始。这样能保证代码风格统一，也方便后续维护。

打开 CubeIDE，点击 File → New → STM32 Project。你会看到芯片选择界面。这里有两种方式：

按型号搜索：比如输入 STM32F103C8T6，直接定位。
按系列筛选：适合你不确定具体型号时用。

选好芯片后，会弹出一个对话框问你要不要初始化所有外设。我一般选 No。为什么？因为我想从零开始，只配我需要的。CubeMX 生成的初始化代码有时候太啰嗦，你想想看，一个简单的 GPIO 点灯，它能给你生成 200 行代码。

小技巧：我个人习惯在工程名里加上日期和版本号，比如 BLDC_Controller_v2.0_20250315。这样过半年回头看，还能知道这个工程是什么时候建的。

创建完成后，你会看到左侧的项目结构。核心文件就几个：

文件/文件夹	作用
`Core/Inc`	头文件目录，放 main.h、gpio.h 等
`Core/Src`	源文件目录，放 main.c、stm32f1xx_it.c 等
`Drivers`	HAL 库和 LL 库的源码
`.ioc` 文件	CubeMX 的图形化配置文件，双击可重新打开

嗯，这里要注意：.ioc 文件是工程的核心。你所有外设的配置都保存在这里。如果你改了 .ioc 文件，CubeIDE 会自动重新生成代码。但有个坑——你手动修改过的用户代码会被覆盖。所以 ST 在生成的代码里留了 /* USER CODE BEGIN */ 和 /* USER CODE END */ 标记。你的代码一定要写在这两个标记之间，否则下次生成就没了。

2.3 调试器配置：ST-Link 与 J-Link

调试器是嵌入式开发的「眼睛」。没有它，你只能靠猜。我最早做电机控制时，有一次 PWM 波形死活出不来，折腾了两天，最后发现是调试器没配置对，时钟没同步上。从那以后，我每次建新工程第一件事就是配调试器。

在 CubeIDE 里配置调试器很简单：

右键工程 → Debug As → Debug Configurations
双击 STM32 Cortex-M C/C++ Application
在 Debugger 选项卡里选择调试器类型

常用的调试器有两种：

ST-Link：ST 官方调试器，几乎所有的 STM32 开发板都板载了它。配置时选 ST-Link (OpenOCD) 即可。接口模式我一般选 SWD，只用两根线（SWDIO + SWCLK），省引脚。
J-Link：SEGGER 家的，速度快，功能强。配置时选 J-Link。注意要安装 J-Link 驱动，并且版本不能太老。我曾经因为 J-Link 驱动版本太低，导致调试时断点打不上，换了新版就好了。

  核心参数设置：
  接口：SWD（推荐）或 JTAG
速度：默认 4MHz，如果线长超过 20cm，降到 1MHz 更稳定
复位模式：选 Connect under reset，这样调试器会在芯片复位时连接，成功率最高

配置好后，点击 Apply 再 Debug。如果一切正常，你会看到代码停在 main() 函数的第一行。这时候你可以单步执行、查看变量、设置断点。

避坑指南：我曾经遇到过一个问题——调试器能连接，但一运行就飞掉。后来发现是 SystemClock_Config() 里配的时钟频率和实际晶振不匹配。比如你板子上是 8MHz 晶振，但代码里配成了 12MHz，那系统时钟就乱了。调试器也救不了你。

2.4 第一个程序：点灯与验证

环境搭好了，调试器也配好了，咱们来跑个点灯程序验证一下。这是嵌入式界的「Hello World」。

在 main.c 的 /* USER CODE BEGIN 2 */ 后面加上：

/* USER CODE BEGIN 2 */
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET);
/* USER CODE END 2 */

然后在 while(1) 里加上：

/* USER CODE BEGIN WHILE */
while (1)
{
  HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0);
  HAL_Delay(500);
  /* USER CODE END WHILE */

  /* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */

编译（Ctrl+B），下载（F11）。如果 LED 以 0.5 秒间隔闪烁，恭喜你，环境搭建成功了。

提示：如果你用的是 STM32G0 或 G4 系列，注意 HAL_Delay() 依赖 SysTick 中断。如果中断优先级配错了，延时可能会不准。我一般会在 HAL_Init() 之后手动调用 HAL_NVIC_SetPriority(SysTick_IRQn, 0, 0) 确保优先级最高。

嗯，到这里，你的开发环境就彻底搭好了。下一章我们会开始真正接触电机控制的核心——PWM 与定时器。到时候你会发现，今天搭的这个模板，会反复用到。

📚 课程目录