1. 为什么我要写这份“宝宝级”安装教程
搞STM32开发，第一步永远不是写代码，而是装环境。我见过太多人卡在安装这一步，代码还没写一行，心态先崩了。STM32CubeMX和Keil5这两个工具，一个是图形化配置引脚和时钟的“搭积木”神器，一个是写代码、编译、烧录的“主战场”。把这两个装好、配对好，后面才能愉快地玩STM32。这篇内容就是给完全没碰过嵌入式的新手写的，从下载到点亮第一颗LED之前的全部环境准备，每一步我都拆开揉碎讲清楚。你不需要任何前置知识，跟着做就行。我会把每个操作背后的原因也讲明白，这样你遇到变体情况时自己能判断，而不是死记步骤。
STM32CubeMX的作用是帮你生成初始化代码。以前配置一个串口要翻手册算寄存器，现在点几下鼠标就搞定。Keil5（具体说是MDK-ARM版本）负责编译和调试。两者配合的逻辑是：CubeMX生成一个工程框架，Keil5打开这个框架继续写业务代码。所以安装顺序、版本匹配、芯片包安装这几个环节一个都不能错。下面我从头开始，把每个坑都标出来。
2. 安装前的准备工作与版本选择
2.1 先搞清楚你要装哪几个东西
很多人以为装一个软件就完事了，实际上完整的STM32开发环境至少包含四样东西：STM32CubeMX本体、Keil MDK-ARM、STM32的芯片支持包（Device Family Pack）、以及对应的编译器版本。CubeMX负责图形化配置并生成代码，Keil负责编译调试，芯片包告诉Keil这颗芯片有多少Flash、多少RAM、寄存器怎么定义。缺了芯片包，Keil打开工程会直接报“Device not found”。
另外还有一个容易被忽略的点：Java运行环境。STM32CubeMX是基于Java开发的，虽然新版安装包里通常自带了JRE，但如果你下载的是某些特定版本，可能需要自己先装Java。我建议直接去官网下载带JRE的完整安装包，省得后面折腾。
2.2 版本怎么选才不踩坑
版本选择这块我踩过不少坑，说几个关键结论。STM32CubeMX建议用6.x系列，比如6.10或6.12，这些版本对Win10/Win11兼容性好，生成的代码也稳定。不要贪新去用刚发布的版本，有时候新版本生成的工程和旧版Keil的兼容性会有小问题。Keil MDK方面，目前主流是5.38或5.39，这两个版本对STM32全系列支持都比较完善。如果你电脑上还装着Keil C51（用来开发51单片机的），那要注意了，C51和MDK可以装在同一台电脑上，但必须装在不同的目录，否则会互相覆盖导致其中一个不能用。
提示：Keil5的安装路径和CubeMX的安装路径都强烈建议不要包含中文和空格。比如不要装在“D:\我的软件\Keil”这种路径下，改成“D:\Keil_v5”这种纯英文路径。很多莫名其妙的编译错误和工程打不开的问题，根源就是路径里有中文。
2.3 下载渠道与文件清单
去ST官网下载STM32CubeMX，需要注册一个账号，流程不复杂，邮箱验证一下就行。Keil的安装包去Keil官网下载MDK-ARM版本。芯片包可以在Keil官网下载，也可以在CubeMX里直接在线安装。我建议芯片包通过CubeMX来管理，因为它会自动匹配你选的芯片型号，省得自己去对型号。
下载完成后你手上应该有这几个文件：STM32CubeMX的安装程序（比如SetupSTM32CubeMX-6.12.0.exe）、Keil MDK的安装程序（比如MDK539.exe）、以及可能的芯片包文件（.pack格式）。把这些文件放在同一个文件夹里，方便一会儿操作。
3. STM32CubeMX的安装与初始配置
3.1 安装过程逐步拆解
双击CubeMX安装程序，第一个界面是欢迎页，直接Next。然后是许可协议，勾选同意，继续。接下来会让你选安装路径，这里就是我前面强调的，选一个纯英文路径，比如“D:\STM32CubeMX”。再下一步是选择开始菜单文件夹，默认就行。然后会出现一个“Install JRE”的选项，如果你的电脑没装Java，这里一定要勾上，让安装程序帮你装。最后点Install，等进度条走完。
安装完成后第一次启动CubeMX，它会问你要不要检查更新，建议先跳过，等环境全部配好再说。主界面出来之后，你可能会发现是英文的。想换成中文的话，在菜单栏找到“Help”，里面有个“Manage embedded software packages”是管芯片包的，而语言设置在“Help”下面的“About”里找不到。正确的位置是：菜单栏“Help”->“Updater Settings”里面没有语言选项。实际上CubeMX的中文设置藏在“Help”->“Manage embedded software packages”旁边那个齿轮图标里，点进去找到“User Interface Language”，选中文即可。如果找不到这个选项，说明你装的版本不支持中文界面，不用纠结，英文界面用习惯了反而查资料更方便。
3.2 芯片包安装的正确姿势
CubeMX装好后，最重要的一步是安装芯片支持包。点击菜单栏的“Help”->“Manage embedded software packages”，会弹出一个大窗口。左边是厂商列表，找到STMicroelectronics，展开后你会看到按系列分组的芯片包，比如STM32F1、STM32F4、STM32H7等等。每个系列后面有个版本号，选最新的稳定版，点“Install”就行。
这里有个实操心得：不要一次性把所有系列的芯片包都装了，那样会占用好几个G的硬盘空间，而且下载时间很长。你用什么芯片就装什么系列的包。比如你手头是STM32F103C8T6，那就只装STM32F1系列的包。等以后用到其他系列再回来装，CubeMX支持随时增删芯片包。
注意：芯片包下载过程中如果网络不稳定，可能会卡在某个百分比不动。这时候不要强行关闭窗口，先等几分钟。如果确实卡死了，关掉CubeMX重新打开，重新进这个管理界面，通常它会断点续传。实在不行就换个时间段再试，ST的服务器有时候确实慢。
3.3 验证CubeMX是否可用
芯片包装好后，点“File”->“New Project”，会弹出芯片选择器。在搜索框里输入你的芯片型号，比如“STM32F103C8”，如果能在列表里看到对应的芯片并且可以选中，说明芯片包装好了。选中后点“Start Project”，如果能正常进入引脚配置界面，看到芯片的引脚图，那CubeMX这部分就算彻底搞定了。
4. Keil MDK-ARM的安装与芯片包配置
4.1 Keil5安装的详细步骤
双击MDK安装程序，欢迎界面点Next。许可协议勾选同意。选择安装路径，同样用纯英文路径，比如“D:\Keil_v5”。接下来会让你填用户信息，随便填一下就行，不影响使用。然后开始安装，等进度条走完。安装快结束时会弹出几个对话框，问你要不要安装ULINK驱动、要不要安装Pack Installer之类的，全部默认勾选，点Next或Install。
安装完成后，Keil会提示你安装完成，点Finish。这时候桌面上会出现Keil uVision5的图标。先不要急着打开，还有关键一步没做。
4.2 许可证管理的基本操作
Keil MDK是商业软件，但有社区版（Community Edition），对于个人学习和非商业项目是免费的。首次打开Keil5，它会弹出License Management窗口。如果你用的是社区版，直接选择“Community Edition”并登录账号激活即可。如果你用的是评估版，会有32KB的代码大小限制，对于学习来说通常够用，但稍微大一点的工程就会编译不过。
这里要特别说明：网上流传的各种注册工具和破解方法，我不建议使用。一方面存在安全风险，另一方面社区版已经完全够学习使用了。而且用非正规方式激活的软件，后续升级和芯片包更新都可能出问题。老老实实用社区版，省心。
4.3 安装STM32芯片包（Device Family Pack）
Keil5本身不认识STM32芯片，需要安装对应的Device Family Pack。有两种方式：一种是在Keil里点“Pack Installer”图标，在线搜索STM32F1、STM32F4等关键词，找到对应的包点Install。另一种是直接双击你从网上下载的.pack文件，它会自动安装到Keil里。
我推荐用Pack Installer在线安装，因为这样能确保版本匹配。打开Pack Installer后，左边找到STMicroelectronics，展开后找到你需要的系列，右边会显示可用的版本，点Install就行。安装完成后，在Keil里新建工程时，搜索芯片型号就能找到了。
提示：如果你同时要用Keil C51和MDK，安装顺序是先装C51再装MDK，这样MDK会自动识别并共存。如果顺序反了，C51可能会覆盖掉MDK的一些文件，导致MDK不能用。万一搞错了，卸载重装就行，不用慌。
4.4 验证Keil5是否配置成功
打开Keil5，点“Project”->“New uVision Project”，随便选一个保存路径，然后会弹出芯片选择窗口。在搜索框输入“STM32F103C8”，如果能在列表里看到“STM32F103C8”并且选中后点OK能正常进入工程界面，说明芯片包安装成功了。这时候你可以试着新建一个空的main.c文件，编译一下，如果没有报错，Keil这部分就OK了。
5. CubeMX与Keil5的联动配置
5.1 在CubeMX中设置工具链
CubeMX生成代码时需要知道你要用哪个IDE。在CubeMX的“Project Manager”标签页里，找到“Toolchain / IDE”选项，下拉菜单里选“MDK-ARM”。版本号选你安装的Keil版本对应的，比如“MDK-ARM V5”。这样生成的工程文件就是Keil能直接打开的格式。
另外在“Code Generator”标签页里，建议勾选“Generate peripheral initialization as a pair of .c/.h files per peripheral”。这个选项会把每个外设的初始化代码分开放在独立的文件里，而不是全部塞在main.c里。对于后续维护和阅读来说，这个设置非常有用。不勾的话，所有初始化代码都在main.c里，工程一大就乱得没法看。
5.2 生成第一个工程并打开
配置好一个简单的工程，比如只开一个GPIO输出用来点灯。在引脚图上找到PC13（很多最小系统板上的LED接在这个引脚），左键点击选择“GPIO_Output”。然后在“Project Manager”里给工程起个名字，选好保存路径，点“Generate Code”。CubeMX会生成完整的工程文件。
生成完成后，它会提示你“Open Project”，点一下就会自动用Keil打开。如果Keil没有自动打开，去生成的工程目录里找到后缀为.uvprojx的文件，双击也能打开。第一次打开可能会提示你安装一些缺失的包，按照提示点安装就行。
5.3 编译与烧录的初次尝试
在Keil里点“Build”按钮（那个像积木的图标），如果一切正常，底部输出窗口会显示“0 Error(s), 0 Warning(s)”。这时候你就得到了一个可以烧录的固件。烧录需要调试器，比如ST-Link。把ST-Link插上电脑，在Keil的“Options for Target”->“Debug”里选择“ST-Link Debugger”，然后点“Settings”确认能识别到芯片。回到主界面点“Download”按钮，固件就烧进去了。
如果烧录失败，最常见的原因是ST-Link驱动没装好，或者芯片的BOOT引脚状态不对。检查设备管理器里ST-Link是否被正确识别，如果没有，去ST官网下载ST-Link驱动装上。BOOT0引脚接低电平（接地）是正常运行模式，接高电平是下载模式，这个根据你的板子设计来。
6. 常见问题与排查技巧实录
6.1 安装类问题速查表
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| CubeMX打不开，闪退 | Java环境缺失或版本不对 | 重装CubeMX，勾选安装JRE |
| Keil提示“Device not found” | 芯片包没装或装错系列 | 用Pack Installer安装对应系列包 |
| 编译报错“cannot open source input file” | 路径含中文或空格 | 把工程移到纯英文路径下 |
| ST-Link识别不到芯片 | 驱动未安装或BOOT引脚不对 | 装ST-Link驱动，检查BOOT0电平 |
| CubeMX生成代码后Keil打开报错 | 工具链版本不匹配 | 在CubeMX里选对MDK-ARM版本 |
6.2 几个我踩过的坑
第一个坑：CubeMX生成工程时，如果工程路径里有中文，生成的Keil工程打开后可能会找不到头文件。这个问题的表现是编译时报一堆“cannot open source input file”，但你去文件夹里看文件明明存在。原因就是路径编码问题。解决办法很简单，把整个工程移到纯英文路径下重新生成。
第二个坑：Keil5和Keil C51共存时，如果先装了MDK再装C51，C51的安装程序可能会把MDK的一些注册表项覆盖掉，导致MDK打开工程时提示“Toolchain not found”。解决办法是先装C51再装MDK，或者装完后修复一下MDK的安装。
第三个坑：CubeMX在线安装芯片包时，如果中途网络断了，重新打开后有时候会显示包已安装但实际不完整。这时候需要先把那个包卸载掉，再重新安装。判断方法是新建工程时搜不到对应芯片，或者生成代码时报错说找不到设备定义。
6.3 独家避坑建议
我个人的习惯是，装好环境后立刻做一个“最小验证工程”：用CubeMX配一个GPIO输出，生成代码，用Keil编译，烧录到板子上，确认LED能闪。这个流程走通了，说明整个工具链没问题。以后遇到任何奇怪的问题，都可以回到这个最小工程来排查，看是环境问题还是代码问题。
另外，建议把CubeMX的工程和Keil的工程放在同一个目录下，但不要混在一起。CubeMX生成的.ioc文件是配置源文件，Keil的.uvprojx是工程文件，两者在同一个文件夹里但互不干扰。每次改配置就打开.ioc文件重新生成，Keil那边会自动更新。不要手动去改CubeMX生成的初始化代码，因为下次重新生成时会被覆盖。自己的业务代码要写在“/* USER CODE BEGIN/”和“/USER CODE END */”之间，这样重新生成时不会被冲掉。
7. 环境搭好之后的第一步
环境装好只是开始，接下来你要做的是熟悉CubeMX的引脚配置逻辑和Keil的工程结构。我的建议是，先不要急着看视频教程，自己动手把CubeMX里每个标签页都点一遍，看看里面有什么选项。比如“Clock Configuration”标签页里可以图形化配置时钟树，你试着把系统时钟从默认的8MHz调到72MHz，看看各个总线的频率怎么变。这种探索比被动看教程学得快得多。
还有一个小技巧：CubeMX生成的代码里，main函数里有一个“SystemClock_Config”函数，里面就是时钟配置的代码。你可以对照着CubeMX里的时钟树图去看这个函数，理解每一行代码对应的是哪个配置项。这样你不仅会用工具，还能明白工具到底帮你做了什么。等你能看懂这个函数了，再去查STM32的参考手册里关于RCC（复位和时钟控制）的章节，理论结合实践，进步会非常快。
最后说一个实际体会：安装过程中遇到报错太正常了，不要一报错就想着重装系统或者换电脑。90%的问题都是路径、版本、驱动这三类原因。按照我上面给的排查表一步步来，基本都能解决。实在搞不定，把报错信息完整复制下来去搜索，通常能找到答案。嵌入式开发就是这样，环境搭好了，后面写代码反而顺畅得多。
