Keil MDK 5.37 编译报错 Default Compiler Version 5 not available 的解决办法

说实话升级到 Keil MDK 5.37 之后我第一次编译老工程就卡在了一个看起来极其诡异的地方。弹出的错误是Default Compiler Version 5 not available紧接着一堆红色报错刷屏连 main 函数都没编译到。我一开始以为是工程配置坏了后来折腾了一整个中午才搞明白这不是你的操作有问题而是从 MDK 5.37 开始Keil 官方默认不再捆绑安装 ARMCCAC5编译器了。ARMCC 是好多老嵌入式工程师的心头好稳定、可控不少老工程的启动文件、汇编代码、第三方库都是基于 AC5 编译链写的。升级 Keil 后这些工程在 5.37 里直接编译不过很多人卡在这一步就放弃了。这篇博文专门说清楚这个问题怎么解决包括 AC5 编译器怎么装、路径怎么配、哪些细节不能踩以及编译过程中最常见的几个报错怎么排查。无论你是刚升级完发现工程崩了还是正打算升级但心里没底这篇都值得看完。1. 问题根源“Default Compiler Version 5 not available”到底在说什么1.1 Keil 5.37 为什么不再自带 ARMCC先说清楚 ARMCC 和 AC6 的关系。Keil MDK 早期默认带的编译器就是 ARMCC也就是 AC5命令行工具是armcc对应的编译标准、内联汇编风格、优化选项都是老一派嵌入式工程师最熟悉的那套。而 AC6 是后来基于 LLVM/clang 架构的新工具链命令行工具是armclang。从 MDK 5.37 开始Keil 官方安装包默认只集成 AC6AC5 变成了一个需要手动安装的可选组件。为什么这么做一个是 ARM 官方已经把 AC5 打入维护状态不再做功能更新所有新特性都往 AC6 上堆另一个是 AC6 在代码体积、性能、C99/C11 支持上确实更有优势。但从使用者的角度来说这就意味着你从 5.36 升级到 5.37老工程只要用到了 AC5 专属的库、汇编语法或者编译选项就会被Default Compiler Version 5 not available卡住。这个报错说白了就是Keil 找不到工程指定的编译器版本但工程还在硬着头皮要找 AC5。1.2 报错的真正含义与影响范围这个报错并不是说你的代码有问题而是 Keil 在工程配置里写明了“用默认编译器版本 5”结果系统里根本没装 AC5于是编译器状态直接变成了不可用。你打开Options for Target - Target在ARM Compiler下拉框里可能看到的是“Use default compiler version 5”但下拉列表里只有Version 6.x根本选不到 Version 5。影响范围比你想象的大不只是老工程早期芯片厂商提供的固件库、DSP 库、RTOS 移植包有很多只发布 AC5 编译好的.lib文件你拿 AC6 去链接直接报一堆符号找不到。一些老启动文件、分散加载文件写死了 AC5 的语法比如__main、__use_no_semihostingAC6 下行为和报错都不一样。工程里大量使用__asm老式内联汇编、__forceinline、__packed这类 AC5 专属关键字AC6 走的是 clang 风格迁移成本很高。所以我的判断很明确如果手里全是老代码没时间做 AC6 迁移老老实实把 AC5 装回来比硬刚 AC6 划算得多。2. 快速解决5 分钟装好 ARMCC 编译器2.1 方案 A手动安装 ARMCC 编译器包推荐AC5 编译器现在不是 Keil 安装包里直接勾选就有了而是需要单独下载编译器包。ARM 官方提供的 AC5 编译器包一般叫ARM Compiler 5.06 update 6或5.06 update 7文件名常见的是ARMCompiler5.06u7之类。我当时是从 Keil 官方旧版本下载页找到的很多芯片厂商的 SDK 里也会附带。安装过程很简单但有几个细节要注意下载好的编译器包是一个.exe可执行文件双击运行安装路径强烈建议选到 Keil 安装目录下比如C:\Keil_v5\ARM\ARMCC。安装完成后打开 Keil进入Options for Target - Target在ARM Compiler下拉框里选择具体的Version 5.06 update 6或者通过右侧的文件夹图标手动指定编译器所在目录。如果下拉框里没有 Version 5可以先点下拉框边上的三个点按钮手动定位到C:\Keil_v5\ARM\ARMCC\binKeil 会自动识别这个目录下的armcc.exe。安装路径千万别带空格和中文这一点极其重要。我之前顺手装到了D:\Program Files (x86)\ARM_Compiler_5.06结果 Keil 识别不干净不说后续还频繁报createprocess failed后来改成D:\Keil_ARMCC_5.06这种纯英文路径才消停。2.2 方案 B从老版本 Keil 里提取 ARMCC如果你手头有老版本的 Keil MDK 5.36 甚至更早的安装包可以直接从里面提取 ARMCC 文件不用再折腾下载。操作方式是这样的安装老版本 Keil 到一个临时目录安装完成之后把Keil_v5\ARM\ARMCC整个文件夹复制出来粘贴到新版 Keil 的C:\Keil_v5\ARM\ARMCC目录下。这样新版 Keil 就能识别到 AC5 编译器了。这里有个容易踩的坑光是复制文件还不行Keil 有时候识别不到编译器版本是因为 TOOLS.INI 里没有注册信息。如果一个 Keil 安装目录识别不到直接在Options for Target里手动指定编译器路径即可。我自己的经验是从 5.36 拷出来的 ARMCC 在 5.37 里用完全没问题但从更老的 5.25 或者 5.14 里拷出来的偶尔会出现编译器版本识别不准确的情况编译出来的代码也可能有细微差异。所以能用官方独立安装包就优先用官方安装包提取老版本只是备用手段。2.3 工程配置选择正确的编译器版本编译器装好接下来就是工程配置。打开Options for Target - Target把ARM Compiler从Use default compiler version 5改成具体的版本号比如Version 5.06 update 7。这一点纯粹是经验之谈不要为了省事保留Use default compiler version这个选项。默认编译器在多个 Keil 版本之间切换时非常不可控尤其你同时装了 AC5 和 AC6一旦 Keil 检测不到 AC5它会悄悄用 AC6 去编译 AC5 的工程然后给你报一堆语法错误你根本反应不过来是编译器版本不对。选好编译器后最好点一下编译按钮看输出窗口里显示的编译命令是否带有armcc字样。如果是ArmClang说明还是没切对。正确设置了之后编译输出会看到类似这样的命令行片段C:\Keil_v5\ARM\ARMCC\bin\armcc.exe --cpu Cortex-M4 --apcsinterwork ...看到这里基本上 AC5 已经生效了。3. 配置过程中的四个关键细节3.1 “Use default compiler version” 别乱勾刚才提到了别用Use default compiler version这里再深挖一下原因。Keil 的编译器版本管理机制和其他 IDE 不太一样它不是每次编译都重新检测系统里装了什么编译器而是优先读取工程文件里的记录。如果工程文件里写的是Use default compiler version 5Keil 会先去找系统注册的 AC5 版本找不到就报错。如果写的是具体版本号比如Version 5.06 update 7Keil 就直接调用这个版本的 armcc。所以在工程配置里一定要把编译器版本写死。尤其团队协作的时候有人装了 5.06 update 6有人装了 5.06 update 7如果都写Use default不同电脑编出来的结果可能完全不同。最稳妥的做法是大家都固定到一个版本同时在工程目录下放一个 README 文件写清楚编译器版本和安装路径。另外在Project - Manage - Project Items - Folders/Extensions里可以看到当前工程使用的编译器路径。这个路径必须是绝对路径不要用相对路径否则在换电脑或者同步代码时会出现找不到编译器的情况。3.2 头文件路径要手动加上AC5 编译器的头文件路径和 AC6 不一样这个很多人会忽略。装了 AC5 之后Keil 不会自动把所有头文件路径加到工程里你需要手动在Options for Target - C/C - Include Paths里检查一下。AC5 的头文件通常在C:\Keil_v5\ARM\ARMCC\include这个目录下里面包含标准 C 库头文件、内建函数定义、CMSIS 相关头文件等。如果这个路径没加对编译时会出现找不到stdio.h、string.h这类基础头文件的报错。还有一个容易忽略的点老工程里经常用到芯片厂商提供的标准外设库这些库的头文件路径里可能会包含相对路径比如..\..\Libraries\CMSIS\Include。当工程文件在新旧编译器之间切换时这些相对路径如果没有根据编译器版本适配编译也会出问题。我在实际项目中遇到过很多次编译错误提示头文件找不到实际查下来就是 Include Paths 里少了一个路径或者路径分隔符写错了。建议在配置完编译器之后第一时间编译一次如果有头文件报错直接去 Include Paths 里把所有缺失路径补齐。千万别相信工程文件里已有的路径是完美的AC5 和 AC6 对路径的解析规则存在细微差别。3.3 C99 模式与 ARMCC 的老特性AC5 默认的 C 标准是 C90/C99 混用模式和 AC6 默认的 C11 差别很大。如果你的代码用到了 C99 的特性比如for循环内声明变量、//注释、指定初始化器等在 AC5 下需要手动开启 C99 模式。在Options for Target - C/C里把C99 Mode勾选上。如果不勾选很多现代代码风格在 AC5 下会报错比如error: #77-D: this declaration has no storage class or type specifier这个报错很多时候不是代码写错了而是编译器标准没选对。另外AC5 支持一些老式关键字像是__asm、__forceinline、__packed、__align这些在 AC6 里有不同的写法。如果代码里大量使用这些关键字建议先做一个全局搜索看看有多少地方用了如果数量不大可以手动替换如果数量很大那说明你的代码深度依赖 AC5更要坚定地安装 AC5 而不是迁到 AC6。还有个细节AC5 的__asm直接内联汇编和 AC6 的差异非常大。比如在 AC5 里写__asm { NOP }是可以的AC6 下面标准写法是__asm(NOP)或者__NOP()。这种差异在初级工程师看来是小问题但实际改动量会很大尤其启动代码和底层驱动里内联汇编到处都是。3.4 编译优化选项不要一步拉满AC5 的优化选项和 AC6 不一样最典型的是 AC5 里有-Ospace优化代码体积和-Otime优化执行速度而 AC6 里用的是-Os、-Oz、-O3这类 clang 风格选项。在Options for Target - C/C - Optimization里AC5 显示的是-O0、-O1、-O2、-O3、-Ospace、-OtimeAC6 则是-O0到-Oz。如果你从 AC6 切回 AC5最好把优化等级先调到-O0或者-O1编译通过之后再慢慢往高调。不要一上来就开-Otime或者-O3AC5 在高优化等级下会产生一些看似莫名其妙的问题比如变量被优化掉、函数被内联、时序不对这些问题在排查时非常耗费时间。我还遇到过一种情况AC5 的-Otime会把某个内联函数展开导致代码段体积异常增大超出链接脚本的RO_SIZE限制直接链接失败。这种错如果不开高优化就根本不会出现很容易让人怀疑是编译器安装出了问题实际上只是优化选项太激进。4. 编译过程中最常见的报错与排查4.1 fromelf 报错createprocess failed这个报错在装了 AC5 之后反而更容易出现原因也很简单Keil 在编译完成之后会调用fromelf.exe生成 bin 文件、反汇编文件或者烧录文件而fromelf.exe所在的路径如果不对就会出现下面这类报错*** error: createprocess failed, command: c:\keil_v5\arm\armcc\bin\fromelf.exe --bin -o ...这背后通常有三个原因路径带空格或中文导致命令行解析出错。Keil 安装目录所在的磁盘没有写入权限fromelf生成文件时被拒绝。杀毒软件拦截了fromelf.exe的启动。我的排查步骤是首先看工程路径和 Keil 安装路径是否包含空格、中文把工程移动到纯英文目录下比如D:\Projects\Demo01。其次以管理员身份运行 Keil这个操作能解决绝大多数写入权限问题。最后如果还是不行关掉杀毒软件对 Keil 目录的实时监控或者把C:\Keil_v5加入白名单。注意fromelf报错不是 AC5 独有的AC6 也会遇到。但 AC5 用户更多一些因为老的批量烧录脚本、生成 bin 文件的命令基本都是基于 fromelf 写的一旦路径不对就会集体报错。4.2 编译报错未包含 main 类型或者找不到 main有些项目在切换编译器之后会莫名其妙报未包含main类型或者链接时提示找不到main但实际上代码里明明写了 main 函数。这个问题的根源通常是启动文件没有正确包含到工程里。以 STM32 为例老工程使用的启动文件往往是startup_stm32f10x_hd.s这种基于 ARMCC 汇编语法的文件如果你的工程里没有正确添加启动文件或者启动文件的路径没有被 Keil 识别链接器就不知道入口函数在哪里自然找不到 main。解决办法分两步看在工程视图里展开启动文件确认它存在于工程中且没有被 exclude 掉。如果启动文件存在但编译不过看一下是不是汇编语法不符合 AC5 规范。AC5 使用老式PRESERVE8、THUMB、AREA语法AC6 也支持但某些老的启动文件在 AC5 下反而更稳。还有一个容易忽略的如果你用的芯片支持包DFP版本太老里面的启动文件可能没有跟上 Keil 5.37 的支持情况。这时候可以在 Pack Installer 里看看有没有更新的 DFP 版本升级之后启动文件会自动更新。4.3 ARMCC 与 AC6 的代码兼容性问题这个不是报错但是是很多人踩坑的起点。同一个工程在 AC6 下编译通过切回 AC5 之后报一堆错最常见的是__attribute__((always_inline))写法在 AC5 下报错AC5 对应的关键字是__forceinline。__attribute__((packed))在 AC5 下不识别AC5 要使用__packed。内联汇编的写法差异AC6 是__asm(nop)AC5 是__asm { nop }或者__asm nop。typedef enum在 AC5 下的默认类型是int在 AC6 下有更严格的类型检测切回 AC5 反而更容易过。如果你是在 AC6 工程上临时切回 AC5编译报错之后不要急着改代码先看报错是语法层面还是链接层面。语法层面的报错可以用#ifdef __CC_ARM做条件编译隔离这样一套代码两个编译器都能编译。4.4 常见问题速查表我在折腾 AC5 的过程中整理了下面这个速查表遇到问题直接对照排查节省大量时间。报错现象可能原因解决办法Default Compiler Version 5 not available系统未安装 AC5 编译器安装 ARM Compiler 5.06u6/u7并在 Target 页指定路径createprocess failed with fromelf路径含空格/中文、权限不足、杀毒拦截工程和 Keil 安装路径改纯英文管理员运行关闭监控找不到 main 或未包含 main 类型启动文件缺失或未被工程包含检查启动文件是否在工程中更新 DFP 版本__use_no_semihosting 未定义标准库链接选项与 AC5 不符勾选 MicroLIB或检查 C/C 配置的链接选项内核头文件找不到Include Paths 未添加 AC5 头文件目录添加C:\Keil_v5\ARM\ARMCC\includearmcc.exe 无法启动安装路径带中文/空格重装到纯英文路径某些库符号找不到第三方库为 AC6 编译或版本不匹配重新获取 AC5 版本库文件这张表其实覆盖了 80% 的问题。剩下 20% 基本是芯片相关、库相关或者是工程配置本身的问题需要具体问题具体分析。5. 编译器版本管理一次配置一劳永逸5.1 固定工程使用的编译器版本很多工程师装完 AC5编译通了就完事了根本不记录工程用什么编译器版本。等到过两个月工程换到另一台电脑或者是自己升级了 Keil又出现Default Compiler Version 5 not available再重新折腾一遍。我的习惯是每个工程根目录下放一个README.md里面第一行就写Toolchain: Keil MDK 5.37 ARM Compiler 5.06 update 7 (ARMCC)这样不管谁来接手这个工程或者多久之后再打开都不会犯迷糊。团队协作时这个做法尤其重要。否则你根本不知道同事用的 AC5 是哪个小版本编译行为差异化问题排查起来极其痛苦。5.2 把编译器包和工程一起归档这个方法是我后来养成的习惯把 ARMCC 编译器的安装包直接放到公司内部的软件仓库或者放到项目服务器的工具链目录下。这样新同事入职、换电脑、重装系统都能快速找到同一个版本的编译器不用去网上重新搜索下载。因为官网的下载链接偶尔会变动网上找的第三方链接又怕带后门统一归档是最安全、最省事的方式。对于个人开发者也建议把下载好的ARMCompiler5.06u7.exe找个网盘或者移动硬盘存一份。这个编译器包现在虽然还能下载到但谁也说不准官方哪天就不再提供了。等到真的找不到了你手里的老工程就只能硬着头皮改 AC6那工作量就大了。5.3 AC5 还能用多久我的实际建议AC5 已经进入维护期ARM 官方不会再给它加新功能新的 ARM Cortex-M85、Cortex-M55 这些内核AC5 支持得也不够全面。所以如果你做的是全新项目直接用 AC6 是更明智的选择没必要为了情怀用老编译器。但如果你手里有大量基于 AC5 的老工程、第三方库或是暂时没时间做代码迁移那么固定好 AC5 版本、做好归档、不要随便升级 Keil这套组合拳能让你再安稳用好几年。我的经验是老工程只要编译器版本固定Keil 大版本不瞎升级产线那边根本不会出什么问题。我现在手上维护的一个量产项目用的就是 Keil 5.37 ARMCC 5.06 update 7编译稳定烧录稳定半年多没出过编译器相关的幺蛾子。就是当初迁移的时候折腾了两天把路径、头文件、启动文件、优化选项全部捋了一遍之后就再也没碰过。如果你正在被这个报错折腾按我上面的步骤操作大概率半小时内能解决。最后分享一个小技巧装完 AC5 后在命令行手动执行一次armcc.exe --version确认编译器能正常输出版本信息再打开 Keil 配置省得在 IDE 里反复试错。