企业官网建设流程全解析

我当初学STM32的时候也干过这事儿：跟着教程一步步装软件，装完四个，傻傻分不清谁是谁。Keil、CubeMX、ST-Link Utility、还有那个看起来像驱动的玩意儿，每个图标都认识，但你要问我它们是干嘛的，我真答不上来。现在回头看，这个阶段特别正常，但确实也暴露了一个问题——我们太急着"装"，而没花时间去理解"为什么要装"。

这篇文章我就把这块窗户纸捅破。不讲高深理论，就基于我最常用的这套开发环境，掰开揉碎说说这四个软件各自扮演什么角色、它们之间怎么配合、以及每个环节最容易踩的坑。看完你至少能明白：你装的不只是四个软件，而是一条完整的嵌入式开发流水线。

1. 内容整体设计与思路拆解

嵌入式开发和写纯软件有个本质区别：你写的代码最终要跑在一块裸芯片上，而不是跑在操作系统里。这就决定了你的工具链不可能只有一个IDE，而是由"生成代码的工具"、"编译代码的工具"、"烧录调试的工具"、"连接芯片的驱动"这四部分构成。

1.1 四个软件到底各自扮演什么角色

我默认你跟我一样用的是最常见的STM32F103系列，配合ST-Link下载器。这个组合下，你装的四个软件基本就是下面这四类：

• Keil MDK：负责"编译代码"和"在线调试"。它把你写的C/C++代码翻译成机器码，然后通过ST-Link把机器码烧进芯片，同时支持断点、单步、查看变量值这些调试操作。它是个大家伙，集编辑、编译、烧录、调试于一体。
• STM32CubeMX：负责"初始化代码生成"。STM32芯片外设多、寄存器配置繁琐，手写初始化代码容易出错。CubeMX用图形化界面让你勾选引脚功能、配置时钟树、设置外设参数，然后一键生成初始化C代码。
• ST-Link Utility：负责"脱离IDE的烧录和芯片维护"。它可以单独烧录hex/bin文件，还能读回Flash内容、修改芯片选项字节、做Flash整片擦除。用Keil调试不方便或芯片被锁死时，它就是救命的工具。
• ST-Link驱动（也就是那个装完好像什么都没发生的软件）：负责让电脑识别ST-Link硬件。没有它，Keil和ST-Link Utility都找不到你的下载器。

这四者协同关系，可以打个比方：CubeMX是"图纸设计师"，先把房子（芯片初始化）的结构画好；Keil是"施工队"，把图纸变成能在芯片上运行的指令；ST-Link Utility是"监理"，可以单独检查或修改芯片里的内容；驱动程序则是"进场许可"，没有它施工队根本进不了工地。

1.2 为什么这个组合是新手入门的"标准答案"

你可能在网上看到有人推荐VS Code + GCC工具链，或者PlatformIO，甚至直接用汇编开发。它们都不是错的，但对新手来说，Keil + CubeMX + ST-Link组合是学习成本最低、资料最全、踩坑最少的方案。

VS Code写嵌入式代码确实现代、美观，但你需要自己配置交叉编译链、链接脚本、烧录插件，任何一个环节出问题都可能让你花半天时间在网上翻帖子。PlatformIO封装得很好，但很多老教程和例程都是基于Keil的，你抄作业时容易对不上。CubeMX生成的初始化代码在Keil里编译，这是ST官方文档推荐的流程，教程、论坛、答疑群里的经验几乎都基于这套方案。

我自己给新人的建议很直接：**第一个月别折腾环境，能用顺手就行，把精力放在看懂代码和调试现象上。**环境是工具，不是学习目标。等你有一定基础了，再去尝试VS Code或Linux下的开发，那时你才知道哪个更适合你。

1.3 这套方案的边界与局限

说句公道话，这套组合也有明显的短板。Keil MDK不是免费的，虽然评估版有代码大小限制（32KB以内免费），但做稍大点的项目就绕不开授权问题。ST-Link Utility的界面风格古老，操作逻辑跟现代工具差异大，而且它正在被STM32CubeProgrammer取代——后者功能更强，支持批量烧录和命令行操作。

所以如果你看到ST官网已经不怎么更新ST-Link Utility了，不用慌。它依然能用，但你要有心理预期：未来你可能会迁移到CubeProgrammer。不过这不影响你现在学习——底层原理相通，工具只是换了个壳。

2. 核心细节解析与实操要点

理解了大分工，我们再深入到每个软件的具体操作要点。这里我不打算把界面按钮一个个截图讲，而是挑最关键、最容易出问题的细节展开。

2.1 Keil MDK：不只是写代码的地方

Keil MDK本质上是ARM公司出的MDK-ARM集成开发环境，核心是Arm Compiler编译器。你在Keil里按F7编译，实际完成的是：预处理、编译、汇编、链接，最后生成一个包含机器码和调试信息的hex文件。

很多新手不知道的细节是，Keil的编译输出目录里有一堆文件，你真正需要关心的只有两个：

• .axf：包含调试信息，用于在线调试
• .hex：纯二进制机器码，用于烧录（CubeMX生成好的工程，Keil默认就会在编译后输出hex文件）

我在实际操作中遇到最多的坑，是新手把代码写好后，按下F8（烧录），Keil提示"Error: Flash Download failed - Cortex-M3"。这个错误有几种常见原因：

• 芯片型号选错：在Options for Target里选的Flash容量与实际芯片不符。比如芯片是STM32F103C8T6（64KB Flash），但工程里选成了CBT6（128KB Flash）。此时Keil的烧录算法（Flash Algorithm）大小不对，就会报错。
• 下载器驱动问题：在Options for Target → Debug标签页，确认选择的是ST-Link Debugger，且Settings里能正确识别到SW Device。
• 芯片被读保护：如果你之前烧录时开启了读保护（Read Out Protection），Keil无法直接擦除，需要先解除保护。

我给新人的实操建议是：Kiel工程设置里的Debug标签页，在Settings里把Reset and Run勾上。这样烧录完程序会自动复位运行，不用你再手动按一下复位键，非常省事。

2.2 CubeMX：别再手动初始化寄存器了

STM32CubeMX的核心价值在于图形化配置、自动生成初始化代码。你做的事情是：选芯片型号 → 配置引脚功能（哪些引脚做GPIO输出、哪些做串口TX/RX）→ 配置时钟（用哪个晶振、PLL倍频到多少、总线时钟频率多少）→ 配置外设参数（波特率、定时器周期、中断优先级等）→ 选择生成的IDE工程格式（MDK-ARM V5）→ 点击Generate Code。

这一套流程下来，CubeMX会在工程里生成类似main.c、stm32f1xx_hal_msp.c这样一堆文件。这些文件里的初始化函数，比如MX_GPIO_Init()、MX_USART1_UART_Init()，写好了你不需要去改。这些代码就是"图纸"，告诉你芯片被配置成了什么状态。

有几个实操要点我必须提醒你：

• 时钟配置是大坑。CubeMX默认的时钟配置可能是HSE（外部晶振），但你的板子可能只焊了HSI（内部RC振荡器）。如果硬件上没接晶振，但你在CubeMX里选了HSE，生成代码后芯片可能无法启动，现象就是程序跑不起来、调试器都连不上。我建议新手直接用HSI，虽然精度差点，但至少稳定。等之后搞懂时钟树了，再根据板子实际硬件改。

• 引脚冲突。CubeMX有个很实用的功能，你配置某个引脚时，它会用不同颜色标识已被占用的引脚，防止你重复使用同一个引脚。但如果你的板子设计不常规（比如PA9和PA10被同时用于串口和LED），CubeMX不会懂你的硬件意图，它只保证引脚不重复。所以硬件原理图上的引脚分配，才是你的最终依据，CubeMX只是帮你检查冲突。

• 生成代码后不要再手动改CubeMX生成的文件。很多人直接在main.c的while(1)里加自己的业务代码，这没问题，但如果你再次在CubeMX里修改配置并重新生成代码，你手动加的部分可能被覆盖。我的做法是：把杂七杂八的业务逻辑单独写在另一个.c文件里，main.c只保留CubeMX生成的内容和自己代码的调用接口。这样CubeMX怎么重新生成都不怕。

2.3 ST-Link Utility：被低估的救场工具

ST-Link Utility是老牌工具，配合ST-Link下载器可以做三件Keil不方便做的事：

• 单独烧录hex/bin文件：比如你从网上拿到一个别人编译好的hex文件（比如某些Bootloader），你用Keil打开它不方便，直接用Utility的"Programming"功能选文件烧进去就行。
• 查看和修改选项字节：STM32芯片里有一块独立于Flash的区域叫Option Bytes，里面存放读保护、写保护、硬件看门狗等配置。用Keil改这些很麻烦，Utility里有专门的标签页，勾一勾就改了。
• Full Chip Erase：当芯片因配置问题无法用Keil正常烧录时，用Utility做一次整片擦除往往能救回来。

这里有个经典场景：新手把芯片的读保护打开了（比如在Keil的Flash Download里勾了某些选项），之后Keil就报错无法烧录。用Utility连接时，它也能检测到芯片处于保护状态。解决办法很简单，在Utility的Option Bytes里，把Level改为0（关闭保护），点击Apply，芯片就恢复原样了。

但有个细节很关键：用Utility改了选项字节后，它会提示"Option bytes changed, do you want to power off?"之类的确认。此时操作不当可能导致电压异常，稳妥起见，改选项字节前保证目标板是独立供电的，不要让ST-Link通过SWD接口供电（如果它支持的话），减少不稳定因素。

2.4 ST-Link驱动：存在感最低的角色

驱动这东西，装好了你几乎感觉不到它，但一旦缺了，整个工具链都瘫痪。ST-Link驱动装上后，你在设备管理器里能看到一个"STMicroelectronics STLink dongle"之类的设备。如果你插上ST-Link电脑没反应，或者Keil识别不到，十有八九是这个驱动没装好。

我遇到过一种情况：装的是64位Windows，设备管理器里ST-Link设备有个黄色感叹号，怎么装都不行。后来发现是电脑上之前装过某个改版驱动，把ST-Link驱动给覆盖了。解决办法是去设备管理器卸载设备并勾选"删除此设备的驱动程序软件"，然后重新安装ST官方驱动。还有一点，ST-Link有V2和V3之分，驱动版本尽量用ST官网最新的，兼容性最好。

另外一个容易被忽略的问题：jtag和SWD模式的区别。ST-Link默认用SWD模式连接目标板芯片，只需要4根线（SWDIO、SWCLK、GND、VCC）。如果你手里的下载器是别的牌子（比如J-Link），它用的协议和软件都不同，ST-Link Utility就不认。搞清楚自己手上工具的型号，别一套教程里的软件对应不上你的硬件，然后怀疑自己装错了。

3. 实操过程与核心环节实现

这部分我按实际开发流程走一遍，从零开始建立一个STM32工程，然后把代码烧进去。这样你能看到四个软件到底在哪个环节被用到。

3.1 环境准备与版本确认

我的建议是，动手前先确认版本。以2025年现在的时间点，我常用的是：

版本太老会遇到兼容性问题，比如CubeMX 5.x生成的工程在Keil 5.3x里打开时可能报芯片包缺失。版本太新也可能有莫名其妙的问题。一般教程里推荐什么版本，你就先用哪个，别急着追新。

另外，Keil装完还需要安装对应芯片的器件支持包（Device Pack）。STM32F1系列对应的是Keil.STM32F1xx_DFP.2.x.x.pack。没装这个包，你在Keil的新建工程里根本找不到STM32F103C8这个型号。CubeMX有时会提示你下载，但你也可以自己在Keil的Pack Installer里装。这一步卡人不浅，很多人装了Keil又装了CubeMX，结果Keil里找不到芯片，就是这个包缺失。

装器件包的体积不大，但下载速度时有抽风。如果遇到下载超时，不要反复点，先去Pack Installer的官网（keil.arm.com/packs）下好pack文件，再在Pack Installer里用"File → Import"手动导入。实测下来比在线安装稳得多。

3.2 用CubeMX生成一个最小工程

我举个最简单的例子：点灯，也就是GPIO输出控制LED。

第一步，打开CubeMX，选择新建工程，在Part Number搜索框输入"STM32F103C8"，选中后点击Start Project。此时会弹出时钟配置界面，先不用管，直接在上方标签页切到"System Core → RCC"，把HSE设为Crystal/Ceramic Resonator（如果你的板子有8MHz晶振）或保持默认（不使用），然后切到"System Core → SYS"，把Debug设为Serial Wire。Debug这步必须设成Serial Wire，否则你用ST-Link调试时可能报连接不上。

第二步，把PC13引脚设为GPIO_Output（我用的板子LED接在PC13，具体看你原理图）。在芯片图或左侧引脚列表中，找到PC13，左键点击选中，选择GPIO_Output即可。

第三步，配置时钟树。在"Clock Configuration"标签页中，如果HSE未启用，系统就用HSI（8MHz）作为时钟源，内部PLL可以把主频倍频到64MHz。STM32F103最快可以跑72MHz，你直接点"HCLK"输入72，CubeMX会自动帮你算PLL的参数。这里注意，CubeMX生成的代码里，会有一个SystemClock_Config()函数，它把所有时钟配置写好了，你不用管具体寄存器值是什么。

第四步，切到"Project Manager"标签页，Project Name填LED_Test，Toolchain / IDE选MDK-ARM V5，其余默认。然后点右上角的"Generate Code"，它会弹窗问你"Open Project?"，点是，它就会打开Keil工程。

到这里，CubeMX的角色就演完了。你已经在Keil里看到一个结构完整的工程了，包含startup启动文件、HAL库源码、以及CubeMX生成的初始化代码。Keil本身也能手动创建空工程，但用CubeMX生成的好处是，它把启动文件和库文件都帮你配好了，省去手动添加文件和配置Include Paths的麻烦。

3.3 在Keil里写业务代码并编译烧录

打开工程后，在左侧项目树里展开Application/User/Core，找到main.c。在main函数里的while(1)循环中，添加LED翻转的代码。我用的HAL库写法：

while (1) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); HAL_Delay(500); }

这两行代码的意思分别是：翻转PC13引脚的电平，再延时500毫秒。HAL库封装得比较厚，但胜在可读性强。如果你以前用标准外设库，会习惯寄存器直接操作，比如GPIOC->ODR ^= GPIO_PIN_13;。现在HAL是主流，你自己选，但帖子里尽量不要混用两种风格的代码，不然排查问题时心累。

写完代码后按F7编译。第一次编译会慢一点，因为HAL库和启动文件都是第一次编译。完成后Keil的Build Output窗口会显示使用的Flash大小和RAM大小。如果显示0 Error(s), 0 Warning(s)，就可以烧录了。

烧录前先确认ST-Link连接到电脑和目标板。点Keil的烧录按钮（或者按F8），如果一切正常，几秒钟后提示Flash Load成功。此时你如果勾了Reset and Run，板子上的LED就开始以1秒周期闪烁了。

这里我想多说一句，很多新手点的烧录按钮其实在Keil工具栏上是"Download"图标，它执行的是把hex文件通过烧录算法写进Flash。但也有个"Debug"按钮，它会把程序下载到Flash并启动调试会话，进入调试模式后程序暂停在main函数开头。你要区分两者：Download就是直接烧录并运行；Debug是烧录后进入调试器，程序会停在断点或main入口处，等你按全速运行键它才会跑起来。很多人点了Debug发现程序"没反应"，其实是它在等你操作，不是死机。

3.4 用ST-Link Utility独立烧录和恢复

现在假设你手上有一个编译好的hex文件，比如app.hex，想烧到板子里。打开ST-Link Utility，点Target → Connect（或直接用快捷键Ctrl+L），它会自动连接ST-Link并识别芯片。然后点"Open file"选择hex文件，点"Program"按钮。烧录完成后，芯片复位运行，程序开始工作。

这个流程看似和Keil烧录重合，但有几个独有价值：

• 当你手里没有Keil工程，只有hex文件时，你必须用独立烧录工具。
• 当Keil连不上芯片时，ST-Link Utility往往还能连上，它可以帮你分析问题（比如检测到芯片处于读保护）。
• 批量生产时，可以用命令行调用Utility批量烧录，不依赖Keil界面。

再补充一个经典恢复场景：芯片内部Flash被写保护了，或者你误开读保护导致Keil烧录失败。用Utility连接，在Option Bytes里把RDP（读保护）级别改为Level 0，然后Apply，芯片就被解除保护了。注意解除读保护时会触发Flash整片擦除，芯片里原有的程序会没了。所以不要指望"解除保护后还能恢复之前烧的程序"。

3.5 整个工作流的全景串联

用一张表来总结这四个软件在你日常开发里的出场顺序：

你注意到没有，Keil覆盖了大多数日常工作，CubeMX只在工程初始化和外设配置调整时出现，ST-Link Utility则是"备用工具"角色。四个软件里真正高频使用的是Keil，但另外三个缺一不可。

4. 常见问题与排查技巧实录

这个部分我总结自己带新人这几年碰到的最高频问题，以及对应的排查顺序。这不是理论推演，每一类我都亲眼见过有人卡住一个下午甚至一整天。

4.1 Keil无法识别ST-Link

现象：插上ST-Link，设备管理器里看得到"STMicroelectronics STLink dongle"，但Keil的Debug设置里找不到设备。

排查步骤按顺序走：

1. 确认ST-Link的驱动状态。设备管理器里设备有没有黄色感叹号？如果有，卸载驱动重装。
2. 确认ST-Link和目标板之间的接线。SWD四根线要对应正确，SWDIO对SWDIO，SWCLK对SWCLK，GND共地。最典型的错误是VCC不接。很多下载器支持从目标板取电检测电平，但不接VCC时，SWDIO的高电平参考电压不确定，通信不稳定，有时能连上有时候不能。把VCC接上，问题往往就消失了。
3. 在Keil的Options → Debug → Settings里点一下"Scan"按钮，让Keil重新枚举。有时候是新插的ST-Link没有被自动刷新出来。
4. 如果以上都不行，用ST-Link Utility连接试试。Utility能连上说明硬件通，Keil设置有问题；Utility也连不上说明硬件问题或其他程序占用了ST-Link。ST-Link同一时间只能被一个软件占用，假如你开着ST-Link Utility没关，Keil就抢不到。

4.2 烧录后程序不运行或运行异常

烧录成功，但板子没反应，这是新手最容易懵的时刻。我的排查顺序：

1. 确认烧录后有没有复位重启。如果没勾Reset and Run，程序确实烧进去了但没运行，手动按一下板子复位键试试。
2. 确认时钟配置与实际硬件一致。CubeMX里如果选了HSE但板子没有外部晶振，程序起不来。把HSE改为Disabled，重新生成代码，烧录测试。
3. 确认引脚有没有接错。点灯的例程里，LED接的是PC13，但板子原理图上LED可能接在PA1或其他引脚。查原理图，再看main.c里GPIO初始化代码对应的是哪个引脚。
4. 确认芯片是否被锁或其他程序占用。如果之前用ST-Link Utility时开启了读写保护，Keil烧录时会偷偷失败或提示。用Utility检查Option Bytes状态。

还有一种少见但很阴性的情况：ST-Link的固件过旧。ST官网提供一个工具叫ST-Link Firmware Upgrade，定期更新ST-Link固件。我遇到过老版本固件的ST-Link配合新版本Keil时报奇怪的错误，一升级就好。建议把固件升级列为备选项，尤其是当你发现自己遇到的问题在网上一搜全是"没遇到过"的时候。

4.3 CubeMX生成工程后Keil打不开

现象：CubeMX点Generate Code，提示成功，但点击Open Project时Keil报了错，或者工程打开了但一堆错误。

这种场景八成是芯片包的问题。CubeMX生成的工程文件里有一行是<Device>STM32F103C8</Device>，Keil要靠这个识别去加载对应的DFP包。如果你的DFP包没装，Keil打开工程时会提示找不到Device，或者编译时直接报找不到核心头文件。

解决办法：在Keil的Pack Installer里查看STM32F1系列DFP包是否已安装。没有就装上。装好后重新打开工程，一般不报错了。

另一种情况是Keil版本太旧，打不开CubeMX新版本生成的工程格式。CubeMX 6.x生成的是MDK-ARM V5格式，需要Keil MDK 5.0+。如果你还在用4.7x那种老古董，尽早换。

4.4 编译报错"cannot open source file xxx.h"

这个问题出现的原因大多是Include路径没配好。CubeMX生成的工程默认把HAL库头文件目录配好了，但你新加的第三方库（比如一些屏幕驱动、传感器驱动）需要手动添加Include路径。

在Keil里点魔术棒图标（Options for Target）→ C/C++标签页 → Include Paths中添加你的头文件所在的文件夹路径。路径之间用分号分隔。还有个细节，路径名最好不要有中文和空格，有些老版本的编译器会因路径里有空格而报错，卡很久才发现是这个原因。

4.5 烧录时提示"No target connected"

这个提示的意思是Keil根本找不到目标芯片。原因概率排序：

1. 目标板没上电或ST-Link没连好线。
2. 芯片处于休眠或低功耗模式，SWD引脚功能被复用或禁用。此时需要用Boot0上拉方式强制启动，再把芯片擦除恢复。
3. 目标板MCU型号不匹配，Keil里选的是别的型号，烧录算法对不上。
4. 芯片损坏（概率不高，但新手画PCB时ESD防护不到位的话可能发生）。

注意第2条：STM32F103的PB3、PB4、PA15等引脚是SWD功能复用引脚，如果你在CubeMX里把它们配置成普通GPIO，且代码里运行后改变了引脚模式，二次烧录时SWD可能会失效。解决的办法是让芯片进入Boot模式（BOOT0拉高），此时SWD功能强制可用，然后用ST-Link Utility把Flash擦掉，再把BOOT0拉低，恢复正常开发。这是新手最容易踩但最难排查的坑之一。

4.6 问得最多：重启上位机软件还是重启板子

调试时程序改了，重新编译烧录一遍，但现象没变化。很多人第一反应是再按一次烧录。其实大多数时候问题在烧录后的复位。如果你排除了代码逻辑错误，先检查是不是板子还在跑旧程序。勾上Reset and Run之后，这种困惑就少了一半。另外，有些开发板有板载调试器的供电开关，如果你烧录时板子供电被切断了，Keil报错是必然的，注意排线不要松了。

4.7 补充一个高效技巧：用命令行批量烧录

ST-Link Utility支持命令行模式，实测在产线上或批量刷程序时特别舒服。比如：

ST-LINK_CLI.exe -c SWD UR -p app.hex -Rst

参数含义是：-c SWD UR表示使用SWD模式连接并设置复位；-p app.hex表示下载hex；-Rst表示下载完成后复位运行。把这行命令写进一个批处理脚本，双击就能刷板子，效率比开Keil还快。对你学习阶段可能用不上，但它解释了ST-Link Utility存在的另一个理由：它的设计目标里有"批量生产"这个角色。

这个工具在ST官网的"STSW-LINK004"页面下载，安装位置里有个ST-LINK_CLI.exe。用命令行时注意看输出信息，连接失败时会有错误码提示，比图形界面还清晰。

5. 拆开看：为什么C++在嵌入式开发里越来越受关注

既然标题里带了C++，我就多聊几句。很多初学者困惑：STM32例程和教程几乎都是C语言，标题里的C++到底在什么场景下有用？

5.1 C++在嵌入式里的价值不只是面向对象

STM32的HAL库是C写的，C++当然可以直接调用这些C接口。你可以在.cpp文件里通过extern "C"包裹C头文件来调用HAL函数。但C++真正的价值在更复杂的项目里体现：

• 封装传感器和外设驱动：把加速度计、显示屏、电机编码器这些都抽象成类，接口统一，调用起来清晰，不容易出错。
• 模板替代宏：以前C语言里用宏定义配置不同型号的器件，C++里可以用模板和constexpr在编译期做选择和计算，类型安全很多。
• 状态机和业务逻辑组织：用类的状态来管理程序状态机的转换，比用一堆switch case清晰不止一个档次。

但C++也有它的代价：编译生成的可执行文件可能比C大（如果滥用特性）、错误信息晦涩、调试时的类型信息复杂。所以我的经验是：如果你做的是小型裸机程序，C够用；一旦项目规模上来了，或者你需要在不同芯片平台间复用业务代码，C++的优势就很明显了。

5.2 用C++写STM32的第一步

CubeMX生成的工程默认是纯C的。你想用C++，有两种方式：

• 把文件后缀从.c改成.cpp。比如把main.c改成main.cpp，Keil会自动用C++编译器处理它。此时需要确保文件头部的C头文件都包了extern "C"，否则链接时会出现符号未定义错误。
• 在Keil的Options → C/C++里把"GNU extensions"等选项按需开启，但新手阶段不建议改太多，先用第一种方式熟悉C++语法在嵌入式里的编译行为。

我在实际项目里是混合用：启动文件、时钟配置这些底层保持C（即使它们被CubeMX生成），用户逻辑部分用C++。这个做法既保留了HAL库兼容性，又让应用层代码好维护。

5.3 新手学C++的优先级

如果你刚开始学C++，且在嵌入式方向，我建议先掌握这几个主题：

• Class与构造函数、析构函数（资源管理）
• 访问控制和封装（把一个外设驱动拆成一个类的头文件和实现文件）
• 引用与指针的区别（嵌入式里指针用得极多）
• 模板的基本用法（比如写一个通用的GPIO控制模板）
• 不要一上来就碰STL或异常处理，裸机环境下很多STL特性不可用，异常处理也需要额外配置

对了，如果你在Keil里用C++调STL，通常会遇到堆空间不足或者std::vector无法使用的问题。STM32F103只有20KB的RAM，用std::vector这种动态分配在裸机上是一种奢侈。嵌入式C++里更常见的是静态数组替代动态容器、裸指针替代智能指针、硬实时逻辑里尽量不用虚函数——这些都是从裸机资源角度出发的妥协。等你去学嵌入式Linux时，才轮到C++的现代化特性全面展开。

6. 给新手的学习路径建议

这篇文章开头说的"装了四个软件不知道干嘛"，本质上是不懂工具链的上下文。解决这个问题的唯一方式是多做项目，在项目里反复使用这套工具，直到你形成肌肉记忆。

6.1 第一个项目建议：不要从点灯开始

我理解点灯是嵌入式界的"Hello World"，但说实话，只点灯对理解工具链帮助有限。我更建议做这样一个练习：

• 用CubeMX配置一个串口（USART1），波特率115200，PA9是TX，PA10是RX。
• 用CubeMX配置一个定时器（TIM2），周期1秒，产生更新中断。
• 编写中断回调，每隔1秒通过串口发送一次"Alive"字符串。
• 用ST-Link Utility的串口助手功能（它也有）或电脑上的串口助手看输出。

这个项目让你用到了CubeMX、Keil、ST-Link、以及串口调试的基础，中途会踩到中断优先级、串口波特率配错、连接线松动等经典坑。做完一次，你对这四个软件的职能就有体感了。

6.2 后续学习路线怎么展开

接着这个起点，我建议按这个顺序进阶：

1. 第二阶段：GPIO输入检测（按键）+ 外部中断。理解中断临界区、消抖。
2. 第三阶段：SPI或I2C协议驱动传感器。理解时序、时钟极性、器件地址。
3. 第四阶段：DMA + 定时器配合实现PWM控制。这里开始接触性能调优的概念。
4. 第五阶段：把各个模块按C++类封装，做一个小型数据采集与显示系统。

走过这几个阶段，你会发现最初纠结的"四个软件是干嘛的"根本不再是个问题。你会在某一刻突然意识到：你已经能够根据项目需求自主选择工具、配置外设、定位问题了。

6.3 一个值得长期保留的习惯

最后分享一个我自己的习惯：每一篇笔记都附带记录"软件版本 + 芯片型号 + 问题描述 + 解决方案"。这听起来很不起眼，但效果极好。三年后你再翻这篇笔记，如果只写了"解决了烧录问题"，你大概率想不起来具体是什么问题。但如果写的是"Keil 5.31 + ST-Link V2 + STM32F103C8T6，烧录报错Flash timeout，解决方式是降低SWD速度从4MHz改为1MHz"，这句话直接就可以在论坛里搜到或者帮助到另一个卡了三小时的网友。

嵌入式开发就是这样一个领域：它不要求你一开始就懂全貌，但要求你每踩一个坑都把它记下来，让那个坑不再吃第二遍。这套工具链也是一样——它们不是四个孤立的软件，而是你熟悉芯片、理解系统的一个个窗口。用熟了，它们就是你手里的工具箱，哪个阶段该用哪个，闭着眼都能摸到。