最近一直在整理 STM32 的学习笔记从点灯到外设驱动一路摸爬滚打踩了不少坑。这篇笔记是个人学习记录的第二篇第一部分专门讲软件安装。别看“装软件”三个字显得基础实际上 STM32 开发环境搭建是否合理直接决定后面烧录、调试、写外设代码的顺畅程度。这篇笔记适合刚接触 STM32、准备从零搭开发环境的初学者也适合那些装了好几次工具链但总在某个环节卡住、想一次性把环境理清楚的朋友。我在这里会把软件安装拆开来讲为什么官方工具链要搭配第三方 IDE 使用、哪些软件是必需的、哪些可以后面再补、每一步安装时有哪些默认选项需要改。所有内容都基于我实际安装和使用的经验过程中还穿插了一些翻车实况和排查思路照着走基本能一气呵成。1. 软件安装的整体思路拆解1.1 先搞清楚 STM32 开发需要哪些软件组件STM32 不是拿来一根 USB 线插上就能写代码的。它是一颗 Cortex-M 内核的单片机要让它跑起来需要解决三件事写代码、编译代码、把编译出来的固件下载到芯片里。每一件事对应不同的软件组件。写代码和编辑工程靠的是 IDE也就是集成开发环境。STM32 最主流的 IDE 是 Keil MDK也叫 MDK-ARM界面老派但用的人多资料好查也有很多人用 ST 官方推出的 STM32CubeIDE免费、内置了编译链和调试器省去很多配置麻烦。编译这件事本质上靠的是 ARM 编译器。Keil MDK 自带 ARMCC 或 AC6 编译器不用单独装STM32CubeIDE 内置了 GCC 工具链同样不用操心。这里容易踩坑的是工程里编译器版本和安装版本不一致导致编译报一堆看不懂的错误后面我会专门说。下载固件需要烧录工具。ST-Link 是 ST 官方的调试下载器驱动装好后Keil 或 CubeIDE 里选 ST-Link Debugger 就能往板子灌程序。很多开发板把 ST-Link 集成在板子上一根 USB 线同时供电和下载所以 ST-Link 驱动几乎是必须的。另外一块是芯片支持包。Keil 不内置所有 STM32 型号的 Flash 算法、启动文件这些内容需要通过 Pack 安装器装对应型号的 Device Pack。比如你用 STM32F103C8T6就要装 Keil.STM32F1xx_DFP 这个支持包。这几个组件组合起来就是一个完整的 STM32 开发环境。我的建议是第一种组合Keil MDK ST-Link 驱动 对应型号 Device Pack适合绝大多数入门项目第二种组合STM32CubeIDE 一把梭适合不想折腾环境的人但后面用第三方库的时候有朋友反映不如 Keil 顺手第三种组合Keil STM32CubeMX 生成初始化代码再导入 Keil这也是我目前最常用的工作流。1.2 选 IDE 的底层逻辑工具链、社区资料与调试体验很多新手上来就问用 Keil 好还是用 STM32CubeIDE 好。我自己的感受是决定因素不是哪个更高级而是你的后续学习路径。Keil MDK 的优势在于资料多。无论是论坛里的老帖子还是各类开发板配套的教程默认都是 Keil 工程。你搜一个“STM32 串口 例程”大概率下载下来就是 .uvprojx 工程文件。这种生态优势对学习阶段来说太关键了遇到问题搜得到抄作业方便。STM32CubeIDE 的优势则是免费、开箱即用、调试界面现代。它基于 Eclipse 开发装完就带编译器和调试支持。它的调试视图里可以直接看外设寄存器变化这是 Keil 免费版没有的体验。不过它吃内存比较狠一个工程编译时风扇转得飞起老电脑会有点吃力。我个人建议初学者先用 Keil MDK理由很朴素你手上的开发板是哪个跟着板子配套教程走教程用什么你用就对了。多数教程都用 Keil所以踩坑最少。等你能独立建工程、跑通下载调试流程再试试 STM32CubeIDE 也不迟。Keil 还有一个需要留意的点它区分评估版和授权版。评估版有 2KB 代码容量限制学习阶段完全够用但如果你用标准外设库或者 HAL 库写一个稍大的工程编译出来的代码量很容易超过 2KB。这时候要么购买授权要么换用 STM32CubeIDE。我不建议在这个环节上折腾什么“绕过限制”的手法正经学习直接用免费方案或申请授权才是稳定的路。2. 核心软件安装流程与配置要点2.1 Keil MDK 安装别急着一路 NextKeil MDK 的安装包可以从官网下载也可以从部分开发板厂商的资料页下载。下载好之后是一个 exe 文件双击运行就开始安装了。我遇到最多的问题是装到一半被杀毒软件拦截或者安装完成后打开工程提示缺少 DLL。安装时注意几个关键点。第一安装路径不要带中文不要装在 Program Files (x86) 以外的地方也不用特意改默认路径通常没问题。第二建议关闭杀毒软件或把安装目录加入白名单因为 Keil 的编译器和调试器组件会被部分安全软件误报。第三安装过程中会让你选择安装组件默认全选即可不需要手动精简。装完 Keil MDK 后桌面上会出现三个图标Keil uVision5、Keil MDK-ARM 的工具链手册入口、以及一个用于许可证管理的工具。如果你用的是评估版打开 Keil 后会在菜单 Project - Manage - License Management 里看到评估模式不要惊讶这是正常的。接下来要装 Device Pack。打开 Keil 之后点击工具栏的 Pack Installer 按钮它会弹出 Pack 管理器窗口。这个窗口左侧是芯片厂商和型号树中间是 Pack 版本列表右侧是已安装的 Pack 信息。找到 STMicroelectronics 目录展开后找到对应你的芯片系列的 Pack比如 STM32F1 Series 就装 Keil.STM32F1xx_DFP点 Install。这里容易卡住的情况是 Pack Installer 下载非常慢或者一直显示“Loading”无法加载列表。这个问题的根源是网络连接官网仓库不稳定。解决办法有两个方向一是等等它加载完列表后先 Install如果卡在下载阶段改用离线 Pack 包安装。离线包通常是 .pack 或 .zip 后缀在 Keil 里用 File - Import Pack 导入即可。2.2 STM32CubeMX 安装图形化初始化的必备工具STM32CubeMX 是一个图形化配置工具它可以根据你在界面上选择的引脚、时钟、外设模式自动生成初始化代码。它不是刚需但在以后学习中断、定时器、I2C、SPI 这些外设的时候能节省大量手写寄存器的时间。安装 STM32CubeMX 需要先装 Java 运行环境因为它是基于 Java 开发的。注意不要装最新版 Java 就万事大吉实际我遇到过用某些 Java 21 版本打不开 CubeMX 的情况换成 Java 17 LTS 之后就正常了。安装 Java 很简单一路 Next装完后在命令行输入 java -version 能看到版本号就说明成功了。CubeMX 安装包同样是 exe 或安装脚本解压后点击安装。它的安装目录可以自定义但同样别带中文路径。安装完成后首次启动它会要求你接受许可协议并确认是否需要自动下载固件包。这个环节容易迷惑人CubeMX 的默认设置会在你选择某个芯片型号时自动去下载对应的固件包比如 STM32F1 的 HAL 库和标准外设库。如果你没配置好代理或者网络不稳定这个下载也会卡住。我的建议是首次启动 CubeMX 时在 Help - Manage embedded software packages 里先检查一下对应型号的固件包版本。如果在线下载慢可以手动从官网下载固件包 zip然后在 CubeMX 里点击左下角的 From Local 按钮导入压缩包。这个操作比在线下载靠谱得多而且是很多教程里没细讲的部分。2.3 ST-Link 驱动安装识别不到芯片的常见来源开发板上的 ST-Link 调试器在电脑上表现为一个 USB 设备。你要烧录代码前提是系统能识别它。Windows 10 和 Windows 11 很多时候插上板子会自动安装驱动但如果你打开设备管理器看到 ST-Link 设备带黄色感叹号说明驱动没有正确安装。ST-Link 驱动可以从 ST 官网下载也可以直接安装 STM32CubeProgrammer 软件这个软件自带驱动。我比较推荐安装 STM32CubeProgrammer因为它的功能不止驱动还提供图形化和命令行烧录接口以后量产烧录、擦除芯片、读取保护位都会用到。安装 ST-Link 驱动时注意USB 线要插在板子上的 USB 口不要插在电脑前置面板的 USB 口上尤其不要插在 USB Hub 上供电不稳会导致 ST-Link 枚举失败。另外如果插上板子后电脑提示“USB 设备无法识别”可以先拔掉板子换个 USB 口再装一次驱动。驱动装上之后在设备管理器里能找到一个“STMicroelectronics STLink Virtual COM Port”和“ST-Link Debug”相关的设备条目。前者是虚拟串口以后串口通信实验靠它后者是调试接口。只有这两个条目都正常Keil 里才能选 ST-Link Debugger 并实现下载。3. 实操过程与工程验证3.1 从零创建一个最小 Keil 工程软件安装完成后我习惯用“点灯程序”验证整个工具链是否连通。下面是基于 Keil MDK 建一个 STM32F103C8T6 最小工程的完整步骤。打开 Keil点击 Project - New uVision Project给工程起名比如 led_test选择保存路径。这里先不要选中“添加启动文件”之类的选项Keil 老版本会让你选设备型号新版本则会在创建后打开 Manage Run-Time Environment 窗口提示你选择需要的组件。选择设备型号时展开 STMicroelectronics 目录找到 STM32F1 系列再选具体型号。比如我的板子是 STM32F103C8T6就选 STM32F103C8。这里选错型号会导致 Flash 算法不对后面下载时报错“No ULINK/MEB found”或者“Error: Flash Download failed - Target DLL has been cancelled”。创建完成后工程里会有一个 Target 选项。右键点击 Target 1选择 Options for Target进入配置窗口。这里面有几个必须检查的项。在 Device 选项卡里确认设备型号。在 Target 选项卡里把 ARM Compiler 选为默认的编译器版本并确认 Use Default Flash Download 选项没被莫名取消。在 Debug 选项卡里右上角选择 ST-Link Debugger然后点 Settings如果驱动正常这里能读到 ST-Link 的序列号和固件版本。在 Utilities 选项卡里勾选 Use Debug Driver否则下载时会提示找不到烧录算法。配置好后往工程里添加一个 main.c 文件写一个最精简的 GPIO 控制程序。这里我不展开写完整代码因为重点是验证工具链不是讲寄存器操作。最简单的点灯流程就是开启 GPIOC 时钟配置 PC13 为推挽输出然后循环翻转该引脚电平。编译通过后点击 Download 按钮烧录。如果一切正常状态栏会出现“FLASH Download: Programming Flash”的进度条最后提示“Application running”。到这里软件安装和工具链验证就全部跑通了。3.2 CubeMX 生成工程并导入 Keil 的操作细节在实际开发中我不会手写全部初始化代码而是用 CubeMX 生成框架再导入 Keil 继续写业务逻辑。这个流程能省掉大量重复劳动但对“软件安装”这个主题来说有一个关键环节需要单独讲CubeMX 生成 Keil 工程时会要求你已经安装对应的 Device Pack否则生成后打开工程会报错。具体操作是在 CubeMX 里选好芯片型号配置好时钟树比如外部晶振 8MHzHCLK 设为 72MHz然后点击 Project Manager 选项卡在 Toolchain / IDE 下拉框里选择 MDK-ARM在 Toolchain Version 里选对应 Keil 版本比如 MDK 5.27 或更高。生成工程时CubeMX 会在你指定的路径下生成一个 .ioc 配置文件和多个子文件夹其中一个名为 MDK-ARM里面就是可打开的 .uvprojx 工程。用 Keil 打开这个工程后会弹出一个提示询问是否自动安装缺少的 Pack。如果之前安装了正确型号的 Device Pack这里不会弹提示直接进入编译环节。这里有一个高频坑CubeMX 默认生成的 Flash 起始地址和大小是针对所选型号自动匹配的一般不用改。但如果你后面要搭配 Bootloader 或做 OTA 升级需要手动在 Keil 的 Target 选项卡里修改 IROM1 的起始地址和大小这个要等学到相关部分再深入。3.3 烧录验证与串口输出的完整流程点灯能跑通只能说内核工作正常。我还建议做一步串口验证确认 ST-Link 虚拟串口也正常因为这离后续调试更近。在 CubeMX 里把 USART1 打开为 Asynchronous 模式波特率设 115200生成代码后在 main 函数里用 HAL_UART_Transmit 发送一段字符串。编译下载后打开串口调试助手选择板子对应的串口号波特率 115200点打开如果能收到字符串说明串口链路没问题。这一步如果发现串口不工作先别急着怀疑程序。大概率是设备管理器里 ST-Link 虚拟串口驱动没装好或者串口调试助手的串口号选错。注意ST-Link 虚拟串口有时会识别成两个串口其中一个不带任何数据要试到对的那一个。另一个验证点是下载速度。Keil 的 Flash Download 选项卡里可以设置编程算法和是否使用编程校验。默认配置下 STM32F103 的烧录速度比较慢但这个速度是安全的。不建议为了追求快把 Erase Full Chip 改成 Erase Sectors 以外的骚操作省下来的几秒钟不值得冒程序跑飞的风险。4. 常见问题与排查技巧实录4.1 编译报错与编译器设置排查编译报错是新手最崩溃的环节但很多报错都是环境问题不是代码问题。举几个我实际遇到的例子。报错“Target uses ARM-Compiler V6.x but the current version is V5.06”意思是工程要求用 AC6但 Keil 当前配置的是 AC5。解决办法是在 Options for Target - Target 选项卡里把 ARM Compiler 切换到 V6。如果列表里没有 V6说明你安装的 Keil 版本比较老可以升级到较新的版本或者装 AC6 补丁。报错“cannot open source input file core_cm3.h”说明芯片支持包没装好。这个头文件是 CMSIS 核心文件由 Device Pack 提供。重新安装对应型号的 Device Pack 基本能解决。报错“Error: L6218E: Undefined symbol”说明有函数声明了但没定义。最常见的原因是启动文件里引用的 SystemInit 函数没有实现这个函数在 system_stm32f1xx.c 里要确认这个文件在工程中。我总结了一个排查顺序先看编译输出窗口里的第一条错误通常真正的根因在最前面后续的错误只是连锁反应。然后检查 Device 型号、Target 里的编译器版本、Pack 是否安装。最后再查代码。这个顺序能过滤掉八成环境问题。4.2 下载失败与调试器识别问题点 Download 之后如果 Keil 提示“Flash Timeout Reset the Target”或者“Cannot access target”原因通常有几个方向。第一个方向是 ST-Link 驱动问题。打开设备管理器如果 ST-Link 相关设备不正常先用 STM32CubeProgrammer 的驱动修复功能或重新安装驱动。第二个方向是 Keil 里调试器设置不对。在 Options for Target - Debug 里左侧要选 ST-Link Debugger然后点 Settings。如果弹出的窗口里 Port 显示 SWMax Clock 是 1MHz 或 4MHz都是正常的。如果显示“No target connected”检查一下板子是否供电ST-Link 排针的 SWDIO、SWCLK、GND 是否接对。第三个方向是 Flash 下载算法没选对。在 Utilities 选项卡里点 SettingsFlash Download 列表里要有对应型号的算法。比如 STM32F103C8 就是 STM32F10x Med-density Flash 64K如果列表为空或选成高密度下载就会失败。还有一个容易被忽略的点有些开发板的 BOOT0 跳线会影响下载。BOOT0 拉高时芯片从系统存储器启动Flash 里的程序不会跑也会导致下载后复位不生效。默认下载前确认 BOOT0 是低电平。4.3 Pack 安装失败与离线安装方案Pack 在线安装失败是很常见的问题尤其是网络不稳定的时候。我在实际安装时也遇到过列表加载不出来、下载到一半断掉的情况。我的处理办法是去官网下载离线 Pack 包后缀名是 .pack然后用 Keil 的 File - Import Pack 导入。导入时需要留意.pack 本质是个 zip 压缩包如果系统把 .pack 识别成压缩文件并自动解压了导入时反而会失败。建议在文件夹选项里不要开启“查看压缩文件”之类的关联操作直接让 Keil 处理原始 .pack 文件。离线安装还有一个好处就是可以顺便把多个型号的 Pack 都装好。比如学习过程中既用 STM32F1 又用 STM32F4一次性下载两个包导入后面切来切去不用再等网络。4.4 其他小毛病与解决思路有个小问题是 Keil 打开工程后代码编辑区不显示语法高亮。这通常不是安装问题而是工程文件路径改变了。Keil 用相对路径搜索头文件如果拷贝工程到别的目录需要重新在 Options for Target - C/C 选项卡里确认 Include Paths 是否正确。另一个小问题是 Keil 每次打开都弹“License Management”窗口。这说明许可证没激活或过期除了获取合法授权外也可以检查环境变量。部分场景下Keil 找不到许可证是由于环境变量“CMSIS_PACK_PATH”指向了无效目录把它的值改为实际安装的 Pack 根目录往往能解决。最后说一个和软件安装无关但很容易让人怀疑是软件装错的问题新板子第一次下载程序后板载 LED 没有反应。这时先别急着卸载软件重装检查一下 LED 的引脚是不是 PC13很多板子的丝印标注和实际引脚定义有出入如果是标准最小系统板还要确认晶振起振了用示波器量或看串口输出比盲改代码效率高得多。5. 我的安装顺序建议与后续扩展思路5.1 一个不会翻车的安装顺序软件安装的顺序看起来无所谓但实际按顺序来能省很多排查时间。我总结了一份排序照着执行基本不会出现“装完了但不知道哪个环节出问题”的尴尬局面。第一步安装 STM32CubeProgrammer。它的作用是给 ST-Link 驱动打下底子后面所有需要连接板子的工具都会舒服很多。第二步安装 Keil MDK。因为 Device Pack 的安装需要 Keil 本体已经就位。第三步打开 Keil 安装对应型号的 Device Pack。第四步安装 Java 和 STM32CubeMX。第五步根据你用的开发板确认驱动是否完全正常用 CubeMX 生成一个最小工程编译下载验证。这个顺序的核心思路是先解决硬件连接层再解决编译工具链最后解决图形化配置。库与中间层的软件包可以在真正用到对应外设时再补不用一开始全装。我试过反过来安装先装 CubeMX 再装 Keil然后发现 CubeMX 生成的工程在 Keil 里打不开就是因为当时 Device Pack 还没装。多花了一个下午排查后来把 Pack 补上问题立刻消失。5.2 扩展方向标准外设库、HAL 库与 CMSIS 之间的关系软件安装完成后下一个绕不开的话题就是“用标准外设库还是 HAL 库”。这部分与软件安装直接相关的点是不同库对应不同的软件包需要额外下载并在 CubeMX 里配置。标准外设库是 ST 早期的固件库直接操作寄存器结构清晰适合理解底层原理但 ST 已经不对它做全面更新了。HAL 库是 ST 主推的库抽象程度高配合 CubeMX 生成代码非常快但代码量大运行效率略低。CMSIS 则是 ARM 提供的硬件抽象层标准不管用什么库底层都脱离不了 CMSIS 头文件和系统初始化。学习阶段我建议先跟教程走教程用哪个库你就装哪个库。如果你决定从寄存器直接学那么标准外设库的软件包也要提前准备好。在 CubeMX 的 Manage embedded software packages 里能按需安装不用怕装多只要硬盘够就行。在动手写第一个工程之前把 CubeMX 的固件包下载这一关也过了后面学定时器、ADC、DMA 的时候效率会高很多。拿我自己来说最初学 STM32 时装软件的那几天确实有点劝退Keil 报错、驱动感叹号、固件包加载不出来每个环节都能卡人。但理顺之后再回看这恰恰是一个很好的“入坑仪式”——让你对工具链的各个组件有个整体认知。后面每次学新模块要么是 CubeMX 里勾一个选项要么是 Keil 里加一个源文件再也不用像最开始那样对一个报错毫无头绪。最后分享一个实用的小习惯装好所有软件后专门建一个“00_EnvTest”的工程文件夹里面保留一个编译通过、下载成功的最小点灯程序。以后换了电脑、重装了系统、或者从别处拷贝了工程第一件事就是打开这个工程试一遍。它能快速验证当前环境是否健康也能在你怀疑编译器配置出错时提供一个可靠的基准对照。我给不少身边的人推荐过这个做法反馈都是省心很多。