1. 为什么新版 Keil MDK 会突然找不到 AC5 编译器如果你最近把 Keil MDK 升级到了 5.37 或更高版本然后打开一个用 STM32 CubeMX 生成的工程点下编译按钮大概率会看到类似这样的报错*** Error: Cannot find ARM Compiler ArmCC version 5或者更直接一点The configured compiler ARMCC is not available.这不是你的工程坏了也不是 CubeMX 生成的代码有问题而是 Keil 从 MDK 5.37 开始默认不再随安装包附带 ARM Compiler 5也就是大家常说的 AC5内部可执行文件叫armcc.exe。官方主推的是 ARM Compiler 6AC6基于 Clang/LLVM但大量存量 STM32 工程——尤其是老一些的 HAL 库版本、标准外设库工程、以及很多第三方中间件——仍然是按 AC5 的语法和编译行为写的直接切到 AC6 会冒出一堆-Wno-...之外的兼容性错误。所以现实情况就是你装了新版 MDK但工程需要 AC5而 AC5 不在安装包里了得自己手动补装。这篇内容就是把我自己反复折腾过好几台机器、好几个 MDK 版本的经验整理出来从原理到实操一步步讲清楚让你能一次性把 AC5 装好、配好、编译通过。适合谁看正在用 STM32 CubeMX 生成工程、用 Keil MDK 5.37 及以上版本、被 AC5 缺失卡住的嵌入式开发者也适合那些想搞清楚 AC5 和 AC6 到底差在哪、为什么不能无脑切换的人。2. 先搞清楚 AC5 和 AC6 到底差在哪2.1 两个编译器的本质区别ARM Compiler 5 的核心是armcc它基于传统的 ARM 自研编译器架构对 C 标准的支持停留在比较早的阶段默认用的是 C90/C99 的宽松模式很多在老工程里常见的写法它都能容忍。ARM Compiler 6 的核心是armclang基于 LLVM/Clang对 C11、C14 甚至部分 C17 支持更好语法检查严格得多优化策略也完全不同。这就导致一个很现实的问题一个在 AC5 下编译零警告的工程换到 AC6 下可能直接报几十个错误。常见的几类隐式函数声明AC5 只给警告AC6 直接报错。__align、__packed这类 ARM 私有扩展关键字的写法差异。内联汇编语法不同AC5 用__asmAC6 用__asm volatile且约束语法变了。链接脚本、scatter file 的写法在 AC6 下需要调整。一些老的标准库、DSP 库、RTOS 移植层根本没适配 AC6。所以对于存量工程最省事、风险最低的做法不是去改代码适配 AC6而是把 AC5 装回来。这也是为什么网上关于 arm compiler 5.06 下载、keil ac5 许可证 的搜索一直很热。2.2 为什么偏偏是 5.06u7 这个版本ARM Compiler 5 有很多小版本5.06 是最后一个大版本系列而5.06 update 7 (build 960)是 5.06 系列里比较成熟、被广泛验证的一个更新。很多 STM32 官方例程、CubeMX 生成的工程模板其默认配置指向的就是这个版本。你如果装的是更老的 5.06u5 或者别的 build有时候工程配置里写死的版本号对不上还是会提示找不到。提示工程里对编译器版本的引用通常记录在.uvprojx文件的ArmAdsMisc或编译器路径配置里。版本对不上时Keil 会认为配置的编译器不可用。所以选 5.06u7 build 960不是因为它有多特殊而是因为它兼容性最好、踩坑最少是社区里公认的稳妥选择。2.3 许可证这件事得说清楚很多人搜 keil ac5 许可证是因为担心 AC5 是不是要单独授权。实际情况是AC5 作为 MDK 的一个组件其授权是跟随 MDK 本身的授权走的。你用 MDK-Lite免费版也好用正式授权也好AC5 的编译器授权状态跟 MDK 主体一致。真正需要注意的是安装路径和注册表配置而不是额外去搞什么单独的 license。这一点后面实操部分会详细讲。3. 安装前的准备工作与版本确认3.1 确认你的 MDK 版本和当前编译器状态动手之前先别急着下载先把现状摸清楚。打开 Keil MDK点Help - About uVision看清楚版本号。如果是 5.37 及以上那基本可以确定 AC5 不在包里了。然后点Project - Manage - Project Items切到Folders/Extensions标签页这里能看到当前工程用的编译器路径。或者更直接打开Options for Target - Target标签页看ARM Compiler下拉框里有哪些选项。如果只有 Use default compiler version 6 或者 V6.x没有 V5.06 的选项那就确认需要手动装了。3.2 需要准备的东西一个 ARM Compiler 5.06u7 (build 960) 的安装包。这个包官方叫ARMCompiler5.06u7或者类似名字通常是一个独立的安装程序也可能是一个压缩包形式。确认你的 MDK 安装根目录默认一般是C:\Keil_v5。管理员权限因为要往 Program Files 或者 Keil 目录里写文件、改配置。注意下载来源要选可靠的。优先从 ARM 官方开发者网站获取或者从你信任的、有校验值的镜像。网上流传的 keil mdk 5.36 网盘 之类资源鱼龙混杂下载后最好核对一下文件大小和数字签名避免装到被篡改的编译器。3.3 安装路径的规划思路这里有个关键决策AC5 到底装到哪。有两种常见做法第一种装到 MDK 安装目录下的ARM\ARMCC或者ARM\ARM_Compiler_5.06u7这类子目录里。好处是集中管理Keil 也容易识别。第二种装到一个独立目录比如C:\Keil_v5\ARM\ARM_Compiler_5.06u7然后在 Keil 里手动指定路径。我个人的习惯是第二种因为这样多个 MDK 版本可以共享同一个 AC5升级 MDK 时不用重装编译器。下面实操部分我按这个思路来。4. 手动安装 AC5 的完整实操流程4.1 运行安装程序并选择目标目录拿到ARMCompiler5.06u7安装包后右键以管理员身份运行。安装向导会问你安装路径这时候不要用它的默认路径默认往往指向一个不存在的旧 MDK 目录手动改成你规划好的路径比如C:\Keil_v5\ARM\ARM_Compiler_5.06u7安装过程很快本质就是把armcc、armlink、armar等一堆可执行文件和头文件、库文件释放到目标目录。装完后你可以去这个目录下看看应该能看到bin文件夹里面有armcc.exe、armlink.exe等。4.2 在 Keil 里注册这个编译器光装好文件还不够得让 Keil 知道它的存在。打开 Keil进Project - Manage - Project Items切到Folders/Extensions标签页。这里有个ARM Compiler区域点右边的...按钮找到你刚才安装的目录选中bin文件夹的上一级也就是ARM_Compiler_5.06u7这一级。选中后Keil 会自动扫描并识别出这是 ARM Compiler 5.06 update 7。你会看到列表里多了一项。4.3 把工程切换到 AC5回到Options for Target - Target标签页ARM Compiler下拉框里现在应该能看到Use default compiler version 5或者直接列出V5.06 update 7 (build 960)。选它。然后重新编译。如果一切顺利之前那个 Cannot find ARM Compiler 的报错就消失了。4.4 验证是否真的生效别急着高兴编译通过不代表用的是 AC5。验证方法看编译输出窗口的 Build Output开头会打印编译器版本信息类似Toolchain: ARM Compiler 5.06 update 7 (build 960)或者你可以在工程里故意写一句 AC5 特有的语法看它认不认。最稳妥的是看Options for Target - Target里选中的是不是 V5.06以及编译日志里的路径指向的是不是你装的那个目录。5. 常见报错与排查速查表装 AC5 这件事说简单也简单但踩坑的地方不少。我把这些年遇到的和网上高频的问题整理成一张表方便你对号入座。报错/现象可能原因解决思路Cannot find ARM Compiler ArmCC version 5未安装 AC5 或未在 Keil 中注册按第 4 章流程安装并注册下拉框里没有 V5.06 选项注册路径选错选到了 bin 里面重新选选到 bin 的上一级目录编译报大量语法错误实际用的是 AC6工程没切过来检查 Options for Target 里的编译器选择提示 license 相关错误MDK 授权状态异常检查 MDK 本身的授权AC5 跟随 MDK编译通过但链接报错库文件版本不匹配确认工程用的库和 AC5 兼容换机器后又要重装编译器路径是绝对路径统一安装路径或做绿色化处理5.1 关于下拉框里没有 V5.06这个高频坑这是最常见的问题。很多人装完 AC5去Folders/Extensions里注册结果选路径的时候手一抖选到了bin文件夹里面或者选到了ARM_Compiler_5.06u7\bin\这一级。Keil 需要的是编译器根目录也就是包含bin、include、lib的那一级。选错了它扫描不到下拉框里自然就没有。5.2 关于编译报错但看起来像 AC6 的错有时候你明明在 Options 里选了 V5.06但编译出来的错误风格还是 AC6 的。这种情况多半是工程文件里某处硬编码了编译器版本或者 Keil 的全局配置没刷新。可以试试关掉 Keil 重新打开工程或者检查.uvprojx里TargetOption下的TargetArmAds配置。5.3 关于多版本 MDK 共存如果你机器上同时装了 MDK 5.36 和 5.37想共用一套 AC5那安装路径就特别重要。建议统一装到C:\Keil_v5\ARM\ARM_Compiler_5.06u7然后两个版本的 MDK 都去注册这个路径。这样升级 MDK 时AC5 不用动。6. 实操心得与避坑经验6.1 安装顺序有讲究我踩过的一个坑是先装了 MDK 5.37再装 AC5结果 AC5 安装程序默认往一个旧路径写装完 Keil 找不到。后来改成先规划好路径安装时手动指定就顺了。所以安装 AC5 时一定要手动指定路径别用默认。6.2 备份你的编译器目录AC5 装好后整个ARM_Compiler_5.06u7目录其实是可以打包备份的。换机器或者重装系统时直接解压到相同路径再去 Keil 里注册一下就能用省得重新找安装包。这个技巧在团队里特别实用新人入职直接给一份五分钟搞定。6.3 关于 CubeMX 生成工程的编译器配置STM32 CubeMX 生成工程时如果你在 Project Manager 里选了 MDK-ARM它生成的.uvprojx默认可能指向 AC6取决于 CubeMX 版本。生成后第一件事就是去 Options 里确认编译器版本别等编译报错了才回头找。我一般会在 CubeMX 的 Project 设置里就把工具链版本选好减少后续手动改的次数。6.4 别轻易全局切 AC6有些教程会说直接切 AC6 就好了这话对新建工程成立对存量工程就是灾难。我见过一个跑了三年的项目切 AC6 后光修语法错误就花了两天还引入了新的运行时问题。所以除非你有充足时间做完整回归测试否则存量工程老老实实用 AC5。6.5 版本号写死的坑有些工程的.uvprojx里会写死编译器版本号比如指定V5.06 update 6而你装的是 update 7。这时候 Keil 可能提示版本不匹配。解决办法是在 Options 里重新选一次编译器让它更新工程配置或者手动改工程文件里的版本字符串。7. 关于 AC5 后续使用的几点提醒AC5 虽然好用但毕竟官方已经停止主推新芯片、新特性支持会越来越弱。我的建议是存量工程继续用 AC5 保稳定新工程尽量用 AC6 起步。这样既不影响老项目维护又能让新项目享受 AC6 更好的优化和标准支持。另外AC5 的安装包和目录建议在团队内部做统一管理别每个人各装各的、路径五花八门。统一路径、统一版本能省掉大量我这能编译你那不能的扯皮时间。最后分享一个我自己的小习惯每装好一套开发环境我都会把关键路径、版本号、注册步骤记在一个env-notes.md里下次换机器或者帮同事配环境时直接照着走比回忆靠谱得多。AC5 这个事装一次记一次后面就是纯体力活了。