2026年了，如果你还在为Keil MDK的安装配置挠头，那真不是个例。我去年底把主力机从Win10换到Win11，重装了一整遍开发环境，顺手把手上几块STM32、GD32的板子都重新烧了一遍，过程中发现MDK 5.39虽然早不是最新版本，但胜在稳定、兼容性好，网上资料也多，对日常嵌入式开发来说非常够用。这篇文章就是我把整个流程完整走了一遍之后的记录，从下载安装到许可证配置，再到汉化、编码、烧录、调试，以及那些你在官方文档里根本找不到的坑，全部整理出来，给同样要装环境的你一个可以直接照着抄的路线图。
我的实测环境是Windows 11 23H2，机器是Intel 12代平台，安装的版本是MDK 5.39（安装包为MDK539.exe），配合ST-Link V2调试器和STM32F103C8T6最小系统板。整个流程在Windows 10 22H2上也完整复验过一遍，结论一致，所以如果你是Win10用户，放心跟着操作。
1. 安装前准备：版本、下载与环境
1.1 MDK 5.39这个版本到底带来了什么
Keil MDK是ARM官方（Arm Keil）推出的嵌入式开发工具套装，其中uVision5是它的集成开发环境界面。很多新手会把“Keil”和“MDK”当成两个东西，其实在ARM生态里，Keil MDK指的是完整的工具链，uVision5则是你看到的那个编辑、编译、调试一体的图形界面。MDK 5.39属于5.x这条产品线里比较成熟的一个版本，它最大的变化是把Arm Compiler 6作为默认编译器，也就是CLANG内核那套，编译速度比老的AC5快不少，报错信息也更能看懂。
同时5.39对Windows 11和最新的ST-Link固件兼容性都做得不错，我是实测跑通的。如果你用的芯片是ST、GD、NXP、瑞萨RA系列，或者国产的很多Cortex-M内核MCU，这个版本都能覆盖。另外MDK 5.39默认支持CMSIS 5.x，配合STM32CubeMX、RASC这类代码生成工具非常顺手，这也是很多老工程师还留在5.x线、不愿意升到AC6.2x甚至Keil Studio的原因。
1.2 官网下载与版本甄别
下载没啥玄学，直接搜“Arm Keil MDK”进官网，找到MDK-ARM的Downloads页面。官网下载是需要注册账号的，随便填一下邮箱就能收到下载链接，实测下载速度还可以。注意下载的时候看清楚文件名，MDK 5.39的Windows安装包一般都叫MDK539.exe，大小大约几百MB，如果你看到的是旧版本号或者名字里带C51，那是另一个产品线，不要下错。
这里我要专门提醒一句：网上搜Keil，永远绕不开“注册机”“破解版”这些字眼。我的态度很明确：别碰。一方面这类工具基本都会被杀毒软件标记，你无法确认里面有没有夹带后门；另一方面Keil的评估模式本身就够个人学习用，代码超过32KB才需要授权。如果公司项目就老老实实买License，真出一次合规问题，省下的那点钱都不够赔的。所以在安装环节我不会教你绕授权，而是把官方允许的评估模式、Community版本和正版License的配置方法讲清楚。
1.3 安装前的系统环境检查
安装前花两分钟检查一下环境能省掉后面很多麻烦。首先是系统位数，MDK 5.39只有64位安装包，Win10/Win11 64位系统没有问题，如果是32位老系统就直接放弃。其次是磁盘空间，安装包加基础组件大约占用2GB左右，如果后面还要装各种芯片的PACK（器件支持包），建议至少留出5GB余量。
再一个就是杀毒软件。Windows Defender一般不会有问题，但如果你装了360、火绒这类软件，安装过程中很可能把关键DLL拦截掉，导致装完打不开或者编译报错。我的习惯是安装之前先把Keil的安装目录加入信任区，或者干脆暂时退出杀毒，装完再开。还有路径问题，Keil默认安装到C:\Keil_v5，我强烈建议不要改成带中文或空格的路径，比如“D:\开发工具\Keil”，这种路径会让很多工具链插件直接罢工，别问我是怎么知道的。
2. 一步步完成安装（2026实测流程）
2.1 安装包的获取与校验
下好MDK539.exe之后，先右键看一下属性里的数字签名，正常的官方安装包是有ARM Limited签名的。这一步能帮你过滤掉很大一部分从非官方渠道下载的安装包。另外如果你是在官网下载的，邮件里的下载链接是有有效期的，有时候在垃圾箱里，记得翻一下。
双击安装包的时候，Windows可能会弹一次UAC用户账户控制，点“是”就行。安装向导启动后会让你选择安装语言，这里选English即可，因为后面我们会单独做汉化，不影响最终效果。
2.2 安装向导中的关键选项
安装流程本身并不复杂，核心就是一路Next，但有几个选项值得注意。到“Choose Destination Location”这一步，默认路径是C:\Keil_v5，我建议保持默认。原因有几个：一是后续很多教程、脚本、插件都假设你装在默认路径；二是如果你把Keil装在非系统盘，某些杀毒软件和磁盘权限设置可能会干扰PACK安装。如果你确实想把整个环境放D盘，那至少保证路径是全英文且没有空格。
到“Device Family Pack”相关提示时，安装向导会建议你在线下载芯片支持包，这时候可以全部跳过，因为在线下载的速度非常不稳定，尤其是第一次使用，经常卡在更新索引那一步半天不动。我们后面用离线PACK的方式手动装，速度更快也更好控制。
安装过程大概几分钟，装完之后桌面会生成uVision5的快捷方式。注意安装包运行完之后，桌面打开的可能是一个空白的uVision窗口，不要慌，PACK还没装，芯片列表是空的，这是正常现象。
2.3 器件支持包（PACK）安装的两种方式
PACK是整个MDK 5.x体系里最核心的部分，它包含了芯片的器件描述、Flash算法、启动文件、例程库等。没有对应的PACK，你新建工程的时候根本找不到想要的芯片型号。
第一种方式是在uVision里打开Pack Installer，通过联网搜索并安装。这种方式的好处是省事，缺点是慢。尤其是在国内网络环境下，光是刷新整个Pack列表就能耗掉你十几分钟，下载大一点像STM32F4系列的PACK，可能要反复中断重来。
第二种方式是离线安装，也是我推荐的方式。直接在Arm Keil官网的“PACK”页面搜索你需要的芯片系列，下载对应的.pack文件。例如ST的M3系列就是Keil.STM32F1xx_DFP.2.4.1.pack，M4系列是Keil.STM32F4xx_DFP.2.17.1.pack，都是一个几百MB的独立文件。下载完成后双击这个.pack文件，uVision会自动识别并导入，整个过程非常快，基本十几秒就完成。
这里有个小技巧：PACK文件可以自己搞一个本地仓库，把常用芯片的.pack都存到D盘一个文件夹里，以后换电脑或者装新环境，双击装一遍就行，不用每次都去官网重新下。我就是这样做了个“Keil离线包合集”，给同事装环境的时候直接分发，效率非常高。
3. 许可证激活与第一次编译
3.1 License Management的正确打开方式
第一次打开uVision5，默认处于评估模式，可以正常使用，但有代码大小限制。想查看License状态，菜单栏选择File，然后点License Management，会弹出许可证管理窗口。这个界面会显示当前是“Evaluation License”，还是有效的“Single-User License”。
如果你买了正版许可证，手上会有一个.lic文件或者一段License ID Code（LIC），直接在下方的“Add LIC”区域粘贴进去，点Add License就能完成激活。整个操作就是点几下鼠标的事，不需要搞得特别复杂。
激活完之后，建议重启一次uVision，然后再次打开License Management确认状态。有时候许可证写入需要管理员权限，所以如果你用普通权限打开Keil，可能激活失败，这时候右键uVision图标，选择“以管理员身份运行”，再操作一遍就好。
3.2 评估模式、Community与正版License的差异
启动“以管理员身份运行”这个习惯建议一直保持，因为Keil编译、下载、调试时涉及驱动访问和文件写入，普通权限下时不时会冒出来一些莫名其妙的问题。评估模式没有任何时间限制，但编译出来的代码限制在32KB以内，对学习和小实验来说其实够用。后面如果做实际项目、代码超过32KB，那就必须用有效License。
另外Arm还提供MDK Community版本，功能和评估版差不多，主要是面向个人非商业用途，你可以在官网找到下载入口。商业项目还是老老实实买授权，这个真没必要省。
3.3 新建工程并完成第一次编译
许可证的事情搞定之后，我们来验证整个工具链是否正常。打开uVision，菜单Project，选择New uVision Project，输入工程名称和保存路径。保存路径同样不能有中文，尽量也放在一个单独的目录下。
下一步是选择芯片型号。如果你刚才正确安装了对应PACK，这里就能找到具体的芯片型号。比如我用的是STM32F103C8T6，在STMicroelectronics -> STM32F1 Series -> STM32F103下就能看到。双击选中芯片，uVision会弹出一个Manage Run-Time Environment窗口，这里可以勾选启动文件、CMSIS等基础组件。
对于STM32F103这类芯片，我一般勾选“CMSIS”下的“CORE”，然后在“Device”下勾选“Startup”。然后写一个最简单的main函数，随便点个GPIO翻转的代码，最后点击F7编译。如果看到“0 Error(s), 0 Warning(s)”，说明安装、激活、PACK全部正常，可以进入下一步。
4. 汉化与编辑器配置
4.1 uVision5汉化包安装步骤
英文界面用顺手了其实没太大问题，但对刚入门的朋友来说，中文界面确实友好很多。uVision5汉化属于“文件替换式”汉化，不是设置里一键切换语言。网上能搜到很多社区分享的汉化包，一般是一个压缩包，里面包含至少3个文件，其中主要是一个~Chinese_Simplified.dll之类的语言文件，以及若干配套资源文件。
操作前先关闭uVision。然后找到Keil安装目录，一般是C:\Keil_v5\UV4，注意虽然软件叫uVision5，但安装目录里这个核心目录依然叫UV4，这是历史遗留，别找错。把UV4文件夹整体复制一份备份，然后把汉化包里的文件复制进去，提示替换就选“全部替换”。重新打开uVision，菜单和右键菜单应该就变成中文了。
这里我实测下来发现一个点：汉化之后90%的界面都没有问题，但个别插件窗口和英文帮助文档里还是英文，这是正常的，不影响使用。另外每次安装新PACK后，PACK Installer的相关界面可能部分回到英文，这是因为它加载的是独立资源，简单重启一下uVision基本就能恢复。
4.2 工程源码编码GBK转UTF-8的完整处理
MDK 5.39在中文Windows上默认打开老工程时，源码编码很容易出问题，典型的症状就是中文注释变成一堆乱码，编译的时候继续报“illegal character”或者“stray \xxx in program”。这个问题的根源在于：Windows中文版的系统区域设置默认使用GBK/CP936编码，而很多新工程、Git仓库里的文件都是UTF-8编码。
解决办法我分两种情况说。
如果你只是想让本地工程正常显示：打开Edit，进入Configuration，在Editor标签页里找到Encoding，把它从默认的“Locale”改成“UTF-8”。改完之后重新打开源文件，中文注释就能正常显示。不过这种方式只影响编辑器的显示方式，并不会把文件内容本身转成UTF-8，所以在跨平台协作时还是不保险。
如果你想彻底把工程转为UTF-8：我建议直接在Keil外面操作，用VS Code、Notepad++这类支持批量转码的编辑器，打开你的.c和.h文件，全部转为“UTF-8 with BOM”格式。注意一定要带BOM，否则部分编译器版本在解析文件头时还是会有问题。转完之后回到Keil里，把Editor的默认编码也改成UTF-8，这样整个工程就彻底统一了。
这个编码问题在嵌入式开发里非常常见，尤其是从旧同事手里接过老工程的场景。我刚干活那两年就因为这个吃过亏，编译报错报得莫名其妙，最后才发现是编码不统一。建议新工程创建时就统一UTF-8，别等代码写多了再来处理，到时候转码很容易引入不可见字符，白白浪费时间。
4.3 编译器版本与代码格式化工具集成
MDK 5.39默认使用Arm Compiler 6，但对于老工程，尤其是一些依赖AC5特有语法的工程，可能会出现编译不过的情况。这时候你可以在工程配置里切换编译器。选中工程，右键，进入Options for Target，在Target标签页的“ARM Compiler”下拉框里选择“Use default compiler version 6”，或者手动选择V5.x，如果没看到V5，需要在Pack Installer里安装“Legacy Support”相关组件。
代码格式化这块，很多人会问Keil有没有自带代码对齐功能。其实uVision自带的对齐功能比较弱，只对选中代码做简单缩进。想要Astyle那种全文件自动对齐，可以做外部工具集成。我目前用的配置是下载一个Astyle的可执行文件，然后在uVision菜单Tools下选择Customize Tools Menu，新增一项“Astyle Format”。Command指向astyle.exe路径，Arguments填“!E --style=allman --indent=spaces=4 --convert-tabs”这样一组参数，其中!E是当前编辑文件路径的占位符。保存后在Tools菜单点一下就能对当前文件做格式化，非常方便。
Cppcheck这类静态检查工具的集成方式也一样，先用包管理器装好Cppcheck，再在Customize Tools Menu里加上，Command指向cppcheck.exe，Arguments填“!E --enable=warning,style --std=c99”，就能在Keil里一键对当前文件做静态检查。虽然这些功能用外部IDE也能实现，但对于习惯了Keil操作的人，集成在同一个环境里还是省事不少。
5. 烧录、调试与目标板连接
5.1 配置调试器并下载Hex文件
先要把编译输出改成Hex格式。选中工程，右键Options for Target，在Output标签页勾上“Create HEX File”，无脑应用。这样每次编译成功之后，工程目录的Listings或Objects文件夹里就会生成一个.hex文件，这个文件可以直接用于烧录。
关于烧录Hex文件的操作，这里要澄清一个常见误区：很多新手以为Keil能像普通烧录软件一样直接打开任意路径的Hex，然后点“下载”就完事了。实际上Keil的烧录流程是编译后自动生成Hex，再通过调试器把当前工程对应的程序写入Flash。如果你想烧录别人发给你的Hex，工程必须和这个Hex对应，或者更简单的方法是用ST-LINK Utility、STM32CubeProgrammer、J-Flash这类独立烧录工具。如果只是开发调试阶段，直接在Keil里点Debug按钮旁边的Download图标，或者按F8，程序就会通过调试器下载到芯片里，不用关心Hex文件在哪。
调试器配置是关键路径。在Options for Target的Debug标签页，把左边的小圆点选到“Use”，下拉框里选择你手上的调试器。ST-Link就选“ST-Link Debugger”，J-Link就选“J-LINK/J-TRACE Cortex”。设置完成后点旁边的Settings，能识别到调试器型号和目标芯片IDCODE，说明连接没问题。在Flash Download标签页，需要添加当前芯片的编程算法，比如STM32F103C8T6就加“STM32F10x Med-density Flash 512K”，如果你漏了这一步，烧录会直接报“Flash Download failed - Target DLL has been cancelled”这种看起来像硬件问题的错误，其实只是算法没配对。
5.2 Debug模式下查看结构体变量的技巧
进入调试模式后，想在Watch窗口查看结构体变量内容，基本操作是在代码里选中变量名，右键选择“Add to Watch”或者“Add to Watch 1”，然后展开变量前的箭头就能看到各成员的值。这个方法本身不难，难的是变量在调试时看不见、显示“ ”这类情况。
产生原因基本是编译器优化把局部变量优化掉了。比如你定义了一个结构体变量，但后续代码没用到它，AC6在-O2优化级别下会直接把这个变量干掉，Watch窗口自然什么都看不到。解决办法有几个方向：一种是把编译优化级别调低，在工程Options的C/C++标签页把Optimization从-O2改成-O0或-O1，牺牲一点代码体积和速度换取调试体验；另一种是在变量定义前加上volatile关键字，告诉编译器这个变量可能被外部修改，不能随便优化掉。
还有一种情况在RTOS调试里经常遇到，比如FreeRTOS的任务控制块（TCB）里头指针特别多，展开以后层层嵌套非常难看。我自己的习惯是在Watch窗口里右键选择“Type Cast”把变量指针强制转换成具体结构体类型，这样就能按实际类型展开，而不是看一串难以理解的十六进制地址。另外如果你用的是J-Link调试器，J-Link自带的RTT Viewer在某些场景下比Keil的Watch窗口更好用，尤其是打印实时日志，这个以后可以单独开一篇讲。
5.3 常见MCU环境（GD32/瑞萨RA/Infineon）适配
MDK 5.39不只是ST芯片的专属，很多国产芯片和日系、欧系MCU都在用它做开发环境。GD32就是一个典型例子，它和STM32引脚兼容、寄存器也大体类似，但启动文件、Flash算法都不一样。所以用MDK开发GD32时，需要安装GigaDevice官方的PACK包，然后在新建工程时选择GD32F10x系列对应的型号，烧录算法也要选GD32的，否则即使能编译通过，下载时也会出问题。
瑞萨RA系列用的是RASC（Renesas Advanced Smart Configurator）生成驱动代码，它可以配置生成一个Keil工程。实际操作是先装好RASC，然后创建工程时选择“Keil MDK”作为生成工具链，生成的工程直接用uVision打开即可。这个流程需要注意版本匹配，RASC和MDK的版本如果跨度太大，生成的工程可能不识别，我建议都装比较新的版本，避免折腾。
英飞凌MCU有对应的Configuration Wizard插件，如果你用的芯片是XMC系列或者PSOC系列，官方也提供Keil环境下的配置工具。思路都差不多：装官方PACK，在工程里调用配置向导，生成代码后编译烧录。所以MDK这套玩法本质上就是“芯片PACK + 工程配置”的组合，你理解了这个套路，换任何芯片都只是换个PACK包的问题。
6. 常见问题与排坑实录
6.1 调试器连接失败：No ULINK Device Found
这个报错我见过太多人问了，新手遇到简直怀疑人生。其实99%不是硬件坏了，而是设置里调试器没选对。MDK新建工程默认用的是ULINK调试器，但大多数人手上的调试器是ST-Link或J-Link，不匹配就会报“No ULINK Device Found”。解决办法在前面章节已经提过：Options for Target -> Debug -> Use，改成你的调试器型号，重新识别一下IDCODE就正常了。
如果改完还是连不上，就要按顺序排查下面几项：第一，目标板是否上电，调试器供电是否正常；第二，调试器驱动是否装好，ST-Link装不上驱动就去ST官网下载STSW-LINK009安装；第三，接线是否有问题，SWDIO、SWCLK、GND这三根线是底线，测试前把其它杜邦线都拔掉排除干扰。最后如果还不行，试试在Debug设置里把连接速率从默认的几MHz降到几百kHz，有时候线材太长、太劣质，高速连接会失败，降速立刻就好。
6.2 卸载不干净导致重装失败
卸载Keil这件事，直接去控制面板卸载是远远不够的。很多朋友反映卸载之后重装，提示“installed components are corrupted”或者激活状态还是旧的，基本都是注册表和残留文件没删干净。
我建议的干净卸载流程是：先在控制面板或设置里正常卸载“Keil uVision5”，然后重启电脑。接着把安装目录，比如C:\Keil_v5整个文件夹删除。再去%LOCALAPPDATA%下找Arm或Keil相关缓存目录，顺手删掉。最后打开注册表编辑器regedit，搜索Keil和ARM关键词，把HKEY_CURRENT_USER\Software\Keil、HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Keil这些项手动删除。注意注册表操作有一定风险，删的时候看清楚路径，别误删系统项。
如果你觉得手删麻烦，可以装个Geek Uninstaller这类卸载工具，它能帮你扫描残留文件和注册表项。我实测下来挺省心的，重装之后没再出现过激活信息残留的问题。
6.3 C51版与MDK共存、老工程迁移注意
常常有人在问Keil C51和MDK能不能共存，答案是能，而且很多工程师就是靠这一套组合混饭吃的。C51主要面向8051内核单片机，比如STC89C52；MDK面向ARM内核，两者本身互不冲突。安装顺序其实无所谓，但推荐先装C51再装MDK，都装到同一个C:\Keil_v5目录下，安装时会自动识别并共享uVision界面。这样你打开同一个uVision，新建工程时如果选择了51芯片，会自动用C51工具链；如果选择ARM芯片，就用MDK工具链，一体化的体验非常好。
如果你把两个版本装到了不同目录，那快捷方式可能指向其中某一个，这时候需要注意手动切换目录下的UV4.exe来打开对应版本。老工程迁移到5.39时还有一个坑，老工程里如果引用了AC5编译器专属语法，或者用了很陈旧的启动文件，直接在新版本里打开可能报错。我建议迁移后先检查一下编译器版本设置，并把Run-Time Environment里的组件重新同步一遍，保证CMSIS版本和PACK匹配，这样基本就能无缝过渡。
6.4 集成外部工具：Astyle与Cppcheck
最后再聊一下外部工具集成带来的一些小麻烦。我用Astyle的时候遇到过一个问题：格式化之后整个文件的中文注释变乱码。原因就是系统默认编码和文件编码不一致，Astyle按系统编码读文件，又用系统编码写回去，把UTF-8文件搞坏了。解决办法是给Astyle命令加上“--ascii”或者“--preserve-encoding”参数，不同版本支持的参数不太一样，不用较劲，直接在格式化之前先确认一下文件编码是GBK还是UTF-8。
Cppcheck集成也有个容易踩的坑，就是它默认检查的是标准的C/C++语法，但嵌入式工程里很多头文件路径、预编译宏它并不知道。所以集成Cppcheck时，最好把工程里的Include路径和常用宏定义补到Arguments里，不然静态检查会打出一堆“missing include”之类的误报，反而掩盖真正的问题。我实际用下来，Cppcheck对空指针、数组越界这类问题确实能抓出不少，配合Keil一遍编译一遍检查，代码质量能提高一大截。
说说我的一些个人体会。刚开始折腾Keil的时候，我觉得这东西又老又繁琐，为什么那么多人还在用。后来用久了才发现，MDK之所以在嵌入式领域根深蒂固，不是因为它的代码编辑器多强，而是因为它把编译、下载、调试这一整套流程做得很稳定，再加上整个芯片生态都以它为标准，任何芯片厂家都会保证自己的PACK优先支持MDK。对于入门阶段的开发者来说，与其纠结工具，不如先把流程跑通，把时间花在真正需要钻研的芯片原理和代码逻辑上。希望这篇从安装到排坑的完整记录能帮你一次顺利装完环境，少走那些我当年走过的弯路。
