企业官网建设流程全解析

刚开始接触STM32的时候，我其实挺排斥图形化配置工具的，总觉得不自己翻寄存器就等于没学会。直到后来带项目、带新人，才发现STM32CubeMX这类工具的真正价值——它把最容易出错、最枯燥的初始化代码和时钟树配置变成了可视化操作，把工程师从寄存器泥潭里解放出来。这篇教程不是官方手册的复制，是我从下载、安装、建工程到跑通SPI读写Flash、集成FreeRTOS一步步走过来的经验总结，适合刚入门的同学，也适合想把手头项目开发效率提一提的老工程师。

1. 从CubeMX说开去：为什么我把图形化配置当成开发标配

1.1 传统开发方式的痛点（我当年的记忆）

十年前我调一块STM32F103，第一步不是写功能逻辑，而是被一堆初始化代码追着跑：GPIO要开时钟，复用功能要查AFR寄存器，串口要算波特率寄存器值，定时器分频要自己掰手指头算，还要祈祷引脚复用没有冲突。这些工作不会让你的技术能力有任何提升，但稍有不慎就是白屏、灯不亮、串口乱码，一查就是半天。

更麻烦的是每个外设的初始化序列还不一样，我当时的做法是到处复制例程，从一个工程里扒GPIO初始化，从另一个工程里扒时钟配置，出了问题完全不知道哪一段是错的。新项目一来，光是把I2C、SPI、UART、定时器这些外设的初始化代码从各种例程里凑齐，就得花掉两三天时间。

1.2 STM32CubeMX能解决什么问题

STM32CubeMX是ST官方提供的图形化配置工具，它和你手写代码的关系，有点像“搬家公司的清单”和“你亲自打包所有纸箱”的关系。你只需要在图形界面里点选芯片型号、配置引脚功能、拖动时钟树的分频系数，这个工具就能自动生成一套结构完整、风格统一的初始化代码，也就是HAL库代码。

它能做的核心事情包括这几类：

• 芯片选型和工程的元信息管理：可以直接从型号列表里选择具体MCU，也可以从开发板模板开始。
• 引脚分配和复用检查：在图形化芯片视图上点击引脚就能分配功能，引脚冲突时软件会直接标红警告。
• 时钟树可视化配置：输入目标主频，软件自动计算PLL分频倍频系数，并校验各总线频率是否超限。
• 外设初始化代码生成：所有配置好的外设都会生成对应的HAL初始化函数。
• 中间件集成：FreeRTOS、FatFs、USB协议栈、LWIP这些常用中间件可以直接勾选引入。
• 功耗估算与引脚状态输出：设计初期就能大致评估功耗，还能生成引脚配置报告。

这带来的直接收益就是：你用鼠标完成的配置，比自己手写代码更规范、更不容易出错。配置的时间从几天缩短到几十分钟，省下来的时间可以真正投入到业务逻辑开发上。

1.3 适用人群与版本生态概览

如果你是刚接触STM32的大学生，我非常推荐直接用CubeMX入门，不必再经历一遍手写初始化代码的痛苦；如果你已经是老工程师，也建议至少把它当成一个“配置检查器”用，它可以帮你快速发现引脚冲突、时钟频率越界这些隐蔽问题。

需要先理解一个生态概念：STM32CubeMX生成的代码依赖HAL库，而HAL库是ST在CMSIS基础上封装的一套硬件抽象层API。平时我们说的“CubeMX生成工程” = 图形化配置 + HAL库源码 + RTOS等中间件。它和Keil MDK、STM32CubeIDE、IAR都能一起工作，工具链方面不存在绑定关系。

另外一个容易被忽略的点是固件包概念。CubeMX本身只是一个配置器，真正生成代码时依赖的是它从ST官网下载的对应芯片系列固件包（比如STM32F1Cube_FW_V1.8.x的压缩包）。所以为什么有的电脑首次生成工程特别慢？就是在下载固件包。

2. 安装前先搞明白这些：版本、Java、固件包

2.1 版本选择：6.x时代已经不需要单独装Java

网上的老教程会告诉你要先安装Java环境、配置JRE变量，那是因为STM32CubeMX 5.x及更早版本确实强依赖Java。但到了6.x版本之后，ST把Java运行时直接打包进了安装程序，安装过程不需要再单独去装JDK或JRE。

如果你看到的教程还在强调“必须先安装Java 8”，那多半是写给旧版CubeMX的，照着做也没错，但完全可以跳过。不过有一个细节要留意：如果电脑里已经装了其他软件依赖的Java，版本较新也没关系，CubeMX 6.x用的是自己内嵌的运行时，两者互不干扰。

我给你一个明确的版本建议：

还要注意一件事：CubeMX更新频率不低，但没必要追新。稳定、用着没毛病就行，我目前主力机用的6.9.x，生成STM32F1、F4、H7系列工程都很顺畅。新版本最大的变化主要在中介层管理和多编译工具链支持上。

2.2 官网下载流程与安装细节

STM32CubeMX的下载入口在ST官网的“工具与软件”板块下，搜索STM32CubeMX就能找到。下载时会要求登录或注册ST账号，这部分是正常的，注册信息也比较简单。需要注意不要把安装包下成“STM32CubeMX的固件包”，它们是两个东西：一个是安装程序本身，大概几百兆；另一个是芯片固件包，在软件内部通过“Manage embedded software packages”管理。

下载完成后的安装过程基本就是一路Next，但有几个选项值得说一下：

• 安装路径不要带中文，我见过不少诡异问题最后都出在中文路径上。安装到默认目录C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeMX完全没问题。
• 首次运行会要求选择工作空间，相当于工程文件的默认保存位置，选择一个专门放STM32工程的文件夹就行。
• 安装时如果提示需要管理权限，正常允许即可，安装过程中会往Program Files目录写入驱动相关组件。

安装完成后桌面会生成快捷键，双击就能启动。如果启动后一直转圈或者卡在某个空白界面，别急着重启电脑，先看下面的首次启动固件包下载问题。

2.3 首次启动：固件包下载慢怎么办

首次打开CubeMX后，界面是英文的，菜单栏看起来空荡荡，这不是软件坏了。当你新建一个工程、选择某个芯片系列时，如果本机没有对应的固件包，软件会弹出窗口提示需要下载，下载过程可能有几百兆，网速不好的时候等待时间会比较长。

有两点经验可以参考：

第一，先去菜单Help里的“Manage embedded software packages”，按需把常用系列勾选下载。不一定全部下载ST所有的芯片系列（那有几十个系列，体积惊人），用哪个系列下哪个就行。

第二，下载过程中间断了不要慌，CubeMX的固件包下载支持断点续传。下载完成后会自动解压，解压失败时软件会提示，这种情况下建议手动删除临时文件后重新下载。我第二次帮同事处理这个问题时，发现他机器上有杀毒软件把固件包解压后的部分dll给隔离了，解压过程反复失败，把固件包目录直接加入白名单就解决了。

如果下载速度实在离谱，可以试试更换网络环境（例如用手机热点分次下载），因为固件包下载依赖ST服务器，不同时段不同网络差异很大。也可以从ST中文官网的镜像资料路径获取固件压缩包，再通过软件内的“From Local”方式导入本地的ZIP文件，这个功能在版本包管理器里是有的。

3. 第一次新建工程到编译下载：点亮一颗LED

3.1 基于芯片型号还是开发板模板

打开CubeMX后第一屏会让你选是“从MCU型号开始”还是“从开发板开始”。如果你用的是常见的NUCLEO、Discovery开发板，直接选“Board Selector”，软件会列出开发板对应的芯片、板载外设，甚至是板载LED、按键对应的引脚，省去大量查原理图的时间。

如果是自己画的板子或者裸芯片方案，就选“MCU Selector”，然后在左侧过滤条件里搜索型号。比如我用过最多的STM32F103C8T6，直接在“Part Number Search”里输入就能定位。选型列表里会显示封装、Flash大小、RAM大小、引脚数量，这些信息用来做选型对比很方便。

3.2 时钟树配置：别被一堆分频系数吓到

新建工程后进入主界面，左边是模式配置区，右边是芯片引脚图，下方的“Clock Configuration”页签是时钟树配置界面。默认情况芯片用的是HSI内部时钟，如果你只做简单点灯，不配外部晶振也能跑。但实际项目中我建议你从一开始就把外部高速时钟HSE配起来，因为内部RC振荡器精度不够，串口波特率、定时器定时都可能有偏差。

以STM32F103C8T6为例，手把手的配置路径：

1. 在“System Core”里选择RCC，把“High Speed Clock(HSE)”设为Crystal/Ceramic Resonator，表示启用外部8MHz晶振。
2. 切换到Clock Configuration页面，把系统时钟来源选为PLL，输入频率设为72MHz。
3. 软件会自动调整PLL倍频系数，把HSE 8MHz倍频到72MHz，并自动设置AHB、APB1、APB2的分频值。
4. 如果某个总线频率超限，界面会弹出红色警告或提示超出范围，这时候适当调整分频系数就行。

当时我第一次用时钟树时，对着各个分频环比划了很久，后来才总结出窍门：不用记所有公式，你只要关注输入源频率、目标主频、总线分频这三个点，其他的软件会帮你算。Clock Configuration页面里直接输入系统时钟目标值，回车，CubeMX会自动处理PLL参数，这个特性在新版本里尤其好用。

3.3 GPIO配置与引脚分配

回到“Pinout & Configuration”页签，左侧选择“System Core”下的GPIO，也可以在右侧芯片图上直接点击某个引脚，在弹出的列表里选择GPIO_Output。

旁边就是GPIO的参数设置面板，有GPIO Output Level（初始电平）、GPIO Mode（推挽/开漏）、GPIO Pull-up/Pull-down（上下拉）、Maximum output speed（翻转速度）等。点灯的典型配置是：Output Mode选Push-Pull，Pull-up不选，Speed选Low，初始电平选High或Low都行，看你想要的LED初始状态。

如果你用NUCLEO板，板载LED通常接在某个固定引脚上（比如NUCLEO-F103RB的LED2在PB13），从开发板模板开始建工程的话，打开后就能看到LED相关的配置。如果是自己设计的板子，记得对照原理图确认LED限流电阻方向和有效电平，这里容易把“高电平点亮”和“低电平点亮”搞反，导致生成代码后灯状态反着。

3.4 Project Manager设置与代码生成

配置完引脚和时钟后，千万别急着生成代码，还有一个重要的页签没弄：“Project Manager”。这里有三个关键区域：

• Project：设置工程名称、保存路径、Toolchain/IDE工具链，以及底层HAL库版本。
• Code Generator：选择拷贝HAL库还是引用外部库，是否生成初始化代码等。
• Advanced Settings：可以逐一勾选每个外设初始化函数的放置位置，通常保持默认。

工具链下拉框里可能出现MDK-ARM V5、MDK-ARM V6、STM32CubeIDE、IAR等选项。这里有两个容易出错的地方，我在后面第6章展开讲。

设置完之后，点击右上角的“GENERATE CODE”，会弹出确认框——设置里的“Project name”和“Path”要注意，路径末尾不要带空格。生成完成后会有提示，点击“Open Project”可以直接打开CubeIDE，如果你是Keil用户，直接去工程目录下的MDK-ARM文件夹找后缀为.uvprojx的文件，用Keil打开即可。

3.5 生成的工程目录结构与Keil调试

生成出来的工程目录通常长这样：

MyProject/ ├── Core/ │ ├── Inc/ // 头文件目录 │ └── Src/ // main.c、gpio.c、usart.c等 ├── Drivers/ │ ├── CMSIS/ // 内核和系统启动相关 │ └── STM32F1xx_HAL_Driver/ // HAL库源码 ├── MDK-ARM/ │ ├── MyProject.uvprojx │ └── startup_stm32f103c8tx.s └── MyProject.ioc // CubeMX工程文件，别删

用Keil打开.uvprojx后，直接编译下载，你会发现点灯程序其实已经能跑了——main.c里生成的代码已经在调用HAL_GPIO_TogglePin或HAL_GPIO_WritePin。

需要特别注意的是main.c里被注释包裹的区域：

/* USER CODE BEGIN WHILE */ while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */

你的业务代码必须写在USER CODE BEGIN和USER CODE END之间。只要写在这两个注解内，下次从CubeMX重新生成代码时，这段代码会被保留；写在注解外，重新生成代码时必定被覆盖。这是使用CubeMX的最重要规则之一，见过太多新手把自定义代码写在main函数别处，结果重新生成工程后丢代码。

4. 进阶实战：SPI读写W25Q64和FreeRTOS任务创建

4.1 用硬件SPI驱动W25Q64的配置路径

很多做嵌入式的朋友都会遇到一个经典场景：用STM32的硬件SPI接口读写W25Q64这个SPI Flash芯片。热搜词里有个长句子“stm32cubemx + hal 库:用硬件spi接口实现w25q64 spi flash芯片的读写操作”，说明这是很多人的作业或项目需求，我重点说一下在CubeMX里怎么把它配出来。

假设你的W25Q64挂在STM32F103的SPI1上，对应引脚通常是PA5(SCK)、PA6(MISO)、PA7(MOSI)，片选CS由任意的普通GPIO控制，或者用SPI的硬件NSS。配置步骤如下：

1. 在左侧“Connectivity”下选中SPI1。
2. Mode设置为Full-Duplex Master。
3. 硬件片选NSS有两种选择：如果CS引脚由独立GPIO控制，就直接把NSS配置为Disable，片选拉低拉高完全由代码控制；如果想用硬件NSS，选Hardware NSS Output Signal。
4. 参数配置上，Prescaler选分发系数（我这里选4，APB2时钟72MHz下SPI时钟18MHz），数据大小8位。
5. CPOL和CPHA这两个极性参数要特别注意，W25Q64手册中描述的是Mode 0或Mode 3都常见，但不同厂家给的示例可能不同。实测中把CPOL设为Low、CPHA设为1 Edge，也就是SPI Mode 0，能兼容大多数W25Q系列芯片。
6. 配置一个GPIO做CS控制，比如PA4，设置为GPIO_Output，初始电平为High（片选无效状态）。

生成代码后，主程序里只需要调用HAL_GPIO_WritePin拉低CS，然后用HAL_SPI_Transmit和HAL_SPI_Receive读写数据。调试SPI有个好帮手，先用逻辑分析仪看波形，确认SCK频率和CPOL/CPHA是否符合预期，再去排查芯片时序问题，避免一上来就怀疑芯片坏了。

4.2 W25Q64基本读写命令与HAL调用

W25Q64容量是8MB（64Mbit），操作它的基本流程需要放在心里：

• 读器件ID：发0x90命令，后面跟3个字节的dummy字节，然后读取2字节，高字节是厂商ID(0xEF)，低字节是设备ID(0x4014表示W25Q64)。
• 写使能：发0x06命令，每次写操作前都必须执行一次。
• 扇区擦除：发0x20命令，一次擦除4KB，把该扇区所有字节置为0xFF。
• 页编程：发0x02命令，一次最多写256字节，写入前必须保证目标区域已被擦除。
• 读数据：发0x03命令，然后连续读取任意长度数据。

CubeMX生成代码后，调用HAL库函数的方法是：

/* 例：读取W25Q64的JEDEC ID */ uint8_t cmd[4] = {0x90, 0x00, 0x00, 0x00}; uint8_t id[2] = {0}; HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, cmd, 4, 100); HAL_SPI_Receive(&hspi1, id, 2, 100); HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_SET);

这里有一个实操细节：SPI是全双工协议，HAL_SPI_Transmit和HAL_SPI_Receive是两个独立调用。如果你用HAL_SPI_Transmit发送读命令，紧接着用HAL_SPI_Receive读取数据，两者之间的CS信号必须保持低电平。如果CS被拉高了再拉低，芯片会认为命令结束，读回来的数据全是0xFF。我调试W25Q64时踩过这个坑，排查了一个晚上才发现CS时序问题。

页编程时要注意跨页问题：一页256字节，如果写入的数据刚好跨越页尾，必须手动切页，否则数据会回头写到页头。这也是HAL库不会帮你做的事，需要自己封装底层驱动时处理。

4.3 集成FreeRTOS：CMSIS-RTOS v1/v2怎么选

CubeMX集成FreeRTOS非常平滑。在左侧“Middleware and Software Packs”里点FREERTOS，Mode选CMSIS_V1或者CMSIS_V2，然后在配置界面里设置堆栈大小、勾选需要调用的RTOS API，软件会自动生成freertos.c，并创建你定义的任务。

这里最让新手迷糊的是CMSIS_V1和CMSIS_V2的区别。简单说：

• CMSIS_V1：对应CMSIS-RTOS v1 API风格，函数名类似osThreadCreate、osDelay。
• CMSIS_V2：对应CMSIS-RTOS v2 API，函数名改为osThreadNew、osDelay，更贴近CMSIS最新规范。
• ST官方新生成的工程模板默认倾向V2，新项目建议直接用V2，老代码用到V1就保持V1，不要在同一工程里混用。

配置任务时，你只需要填写任务名称、优先级、栈大小和入口函数。CubeMX生成的代码会在freertos.c中自动创建任务函数体，类似：

void DefaultTask(void *argument) { /* USER CODE BEGIN DefaultTask */ for(;;) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); osDelay(500); } /* USER CODE END DefaultTask */ }

任务代码同样要写在USER CODE注解内，否则重新生成代码会被清掉。还要注意CubeMX生成的FreeRTOS默认配置里，Heap大小是固定的，如果任务创建较多或者队列使用内存较大，记得在FreeRTOS参数配置中把Heap Size调大，否则运行时会出现任务创建失败。

4.4 与STM32CubeIDE的配合使用

CubeMX生成代码后，直接点击“Open Project”，可以自动启动STM32CubeIDE并导入工程。CubeIDE基于Eclipse，免费且功能完整，调试直接在IDE内部完成，对新手很友好。和Keil+ST-Link的调试体验相比，CubeIDE的优点是免费、跨平台，而且能与CubeMX严格同步工程格式。

我个人目前的习惯是，需要用商业功能或老同事协作时用Keil，自己独立做小项目时直接用CubeIDE。两者切换的方式也很简单：在CubeMX的Project Manager里切换Toolchain，再重新生成一次代码就行，不影响手写的USER CODE区域。

5. 中文汉化：给CubeMX换个语言界面

5.1 汉化的具体操作步骤

很多新手一看满屏英文发愁，其实CubeMX官方是支持多语言界面的，包含中文。汉化的步骤不难：

1. 打开CubeMX菜单栏Help。
2. 选择“Install New Languages”。
3. 在弹出的管理窗口中勾选“Chinese”，点击“Install”。
4. 软件会下载对应的语言包，下载完成后重启CubeMX。
5. 重启后如果界面仍是英文，去Help里的“Select Language”手动切换为中文，或者看提示重新启动软件。

这里需要说明的是，网上流传的所谓“CubeMX汉化补丁”大多是把界面语言包硬塞进去，有版本兼容风险，我不推荐。能走官方功能的就Walk官方路径，干净又稳定。

5.2 汉化不彻底和新版的坑

汉化之后的实际体验是，主界面菜单、右键菜单这类能汉化，但很多专业名词、配置项名称以及错误提示仍然是英文。这其实是正常现象，不要指望像中文软件那样做到100%汉化。HAL库源码里的注释也都还是英文，所以该积累的英文术语还是绕不开，比如GPIO Mode、Pull-up、Prescaler这些，早记住早省事。

还有一个坑：新版CubeMX的有些版本（比如6.9.x之后）对中文语言包的支持存在优化不佳的情况，偶尔切换中文后部分界面布局会错乱。我的建议是，为了排错和搜索问题方便，界面语言保持英文其实更实用，因为大部分编译报错、CSDN教程、ST官方文档里的截图都是英文界面，你用中文界面反而对不上号。

所以我把“汉化”放在比较靠后的章节，你的产品别在汉化上花太多时间，界面认得出菜单就够用了，精力还是放在配置和代码上。

6. 你可能遇到的一堆问题：打不开、没有MDK-ARM、芯片包不显示

6.1 CubeMX打不开怎么回事

“stm32cubemx打不开怎么回事”这个问题在社区里出现频率极高，我刚安装的时候也折腾过一次。打不开分为几种情况，排查思路如下：

• 双击没反应：先看任务管理器里有没有STM32CubeMX进程残留。有时候程序异常退出后进程还挂在后台，再次双击就永远不弹窗口。解决方案是结束相关进程后重试。
• 卡在启动Logo或白屏：多数是工作空间设置异常，或者之前的工程缓存损坏。可以找到CubeMX安装目录下的.metadata缓存文件夹，备份后删除，让软件重新初始化。注意这里的.metadata放在工作空间目录里，不是你电脑里所有叫.metadata的文件夹都去删。
• 老版本Java报错弹窗：如果你用的是非常旧的CubeMX 5.x，安装时注意环境必须要有Java运行时。检查方法是在命令行输入java -version，没安装就去把JRE 8装上。新版6.x用户直接忽略这条。
• 杀毒软件误拦截：这个我遇到过，CubeMX首次运行时会释放一些组件，部分杀毒软件会拦截导致安装不完整。把安装和运行目录加入白名单，重新安装一次即可。
• 显卡或驱动问题：极少数情况下的UI花屏或黑屏，可以尝试更新显卡驱动，或把CubeMX的图形渲染方式切换为兼容模式，在CubeMX设置里有一个“Disable hardware acceleration”相关选项。

6.2 生成代码时没有MDK-ARM选项

“stm32cubemx没有mdkarm”是另一个高频搜索词。这里要先分清是生成代码时Toolchain下拉框里找不到MDK-ARM，还是下拉框里有但生成不了。

第一种情况多数是CubeMX版本太旧。早在5.x时代，MDK-ARM是工具链默认选项，而6.x之后工具链管理器才细化了MDK-ARM V5和V6的区分。如果下拉框里只有“MDK-ARM V5”但你自己装的是Keil MDK V5.36以上的新版本，也没问题，V5工具链选项对应的是ARM Compiler V5编译器。如果你用的是Keil MDK 6.x安装包，则应该选择MDK-ARM V6。

但要注意，即使Toolchain下拉框里选了MDK-ARM，CubeMX本身并不知道你电脑上的Keil装在哪个路径，它生成的工程和编译器是解耦的。你只需要打开MDK-ARM目录下的.uvprojx文件，确保Keil安装无缺少的库和Pack即可。

有时候还会遇到另一种怪现象：下拉框里没有MDK-ARM，但自己的Keil能正常编译其他工程。这种情况我遇到过一回，原因是CubeMX安装时选择的组件不完整，某个支持第三方IDE的组件没装上。最简单的修复是卸载CubeMX，重新用安装包完整安装，安装界面里的组件不要手动取消。

6.3 芯片型号/固件包不显示或下载失败

新建工程时搜索不到某个芯片，绝大多数原因是该芯片系列的固件包没装。回到菜单Help，选择“Manage embedded software packages”，在“STMicroelectronics”标签页里展开对应系列，勾选后点击安装。

如果固件包下载到一半失败，CubeMX通常会在一个临时目录保留已下载的部分文件，下次重试会尝试续传，但偶尔会卡在99%不动。我的处理办法是：

1. 删除临时文件目录中对应型号的残留文件。
2. 手动从ST官网下载对应系列固件压缩包。
3. 在版本包管理器里用“From Local”导入。

展开的过程其实就是一个ZIP解压的过程，手动导入完全兼容。之所以有时候下载失败是因为固件包体积大且服务器连接不稳定，跟网速关系也很大，多试几次或换网络环境是最土著的办法。

6.4 我的几个日常习惯和排查思路

用了这么多年CubeMX，在最后分享几个我一直坚持的习惯，算是给这篇教程收个尾。

第一，每个项目单独建一个文件夹，里面放.ioc文件、固件包版本记录、原理图PDF和数据手册。CubeMX工程文件只有几十KB，但数据手册和原理图才是排查问题时的第一手资料。

第二，改硬件配置前先备份.ioc文件。在CubeMX里做大规模引脚重映射之前，把当前.ioc文件复制一份另存。软件虽然有撤销功能，但撤销几步之后界面状态很容易乱，备份文件是最可靠的回退方案。

第三，养成看红色警告的习惯。配置引脚时界面上出现红色标记，不要直接忽略，那代表引脚冲突或模式组合非法。把鼠标悬停在警告位置，软件会告诉你冲突原因，大部分情况下是你把同一个引脚分配给了两个外设，或者某个功能必须占用特定引脚。

第四，生成代码后先编译一次再动业务代码。CubeMX刚生成的工程在不改任何代码的情况下，编译必须零错误零警告，如果这一步都过不去，检查你的Keil配置、芯片头文件版本、固件包版本，而不是急着写业务功能。

我遇到过最坑的一次经历是配置外部晶振后，生成的代码里PLL配置有误，导致下载后调试器无法连接，只能强制复位芯片重新擦除。后来学乖了，每次下载新程序前先确认复位引脚和BOOT0配置，如果程序跑飞了也能用串口ISP的方式把芯片救回来。

工具说到底是为项目服务的，CubeMX省下来的时间，值得投入到真正有意义的事情上，比如把SPI驱动的稳定性调好，把FreeRTOS的任务优先级设计得更合理。希望这篇从下载安装到实战排查的教程，能帮你少走几步弯路。