Keil MDK-ARM 5.37 编译报错：ARM Compiler 5 缺失的三种解决方案

1. 项目概述：当Keil MDK-ARM 5.37遇上“编译器版本5”的拦路虎

如果你最近刚把Keil MDK-ARM（我们习惯叫它Keil5）升级到了最新的5.37版本，兴冲冲地打开一个老项目，或者从网上下载了一个例程准备编译，结果弹出一个让你心头一紧的报错：*** target ‘target 1‘ uses arm-compiler ‘default compiler version 5‘ which is not available.，那么恭喜你，你遇到了一个非常典型但又有点“坑”的版本兼容性问题。这个报错的核心，不是你的代码写错了，也不是你的安装包有问题，而是Keil5.37这个版本在编译器管理策略上做了一个比较激进的调整。

简单来说，从Keil MDK-ARM 5.37版本开始，官方默认不再预装经典的“ARM Compiler 5”（也就是我们常说的ARMCC v5）。这个编译器版本历史悠久，稳定可靠，是过去十几年里无数STM32、NXP、TI Cortex-M芯片项目开发的基石。很多老项目、开源库、甚至是芯片厂商提供的标准外设库、HAL库例程，其工程模板默认配置的都是这个“Compiler version 5”。当你用新版的Keil5.37打开这些工程时，软件找不到这个编译器，自然就报错了。

这不仅仅是新手会遇到的问题，很多经验丰富的工程师在升级开发环境或者在新电脑上配置环境时，同样会一头撞上。它背后涉及的是嵌入式开发中工具链的版本管理、工程配置的继承性，以及如何平衡新特性与旧有生态兼容性的经典矛盾。接下来，我会带你彻底拆解这个问题，从根因分析到三种不同的解决方案，并分享一些我踩过坑之后总结的配置心得，让你不仅能解决眼前的问题，更能理解背后的逻辑，以后遇到类似工具链问题都能从容应对。

2. 核心问题深度解析：为什么ARM Compiler 5“消失”了？

要解决问题，首先要理解问题是怎么来的。这个报错不是一个Bug，而是Keil官方有意为之的一次产品策略变更。我们可以从几个层面来理解。

2.1 ARM Compiler 5与ARM Compiler 6的世代更迭

ARM Compiler 5（ARMCC）是基于传统的C/C++编译器框架，它伴随ARM Cortex-M内核的崛起而成为嵌入式开发的事实标准。它的优势在于极致的兼容性和稳定性，几乎所有芯片厂商的启动文件、底层汇编代码、链接脚本都是针对它优化或编写的。然而，它的技术架构相对老旧，在代码优化效率、对现代C++标准的支持等方面逐渐力不从心。

于是，ARM推出了ARM Compiler 6（ARMCLANG）。它基于LLVM/Clang框架，带来了更先进的优化算法、更好的错误提示信息、对C++14/17等新标准的支持，以及更现代化的工具链架构。从长远看，ARM Compiler 6是未来。因此，Keil MDK近年来一直在推动用户从AC5迁移到AC6。

2.2 Keil 5.37版本的“破釜沉舟”之举

在5.37版本之前，Keil MDK的安装包是同时包含ARM Compiler 5和ARM Compiler 6的。工程里可以自由选择使用哪一个。但这也导致了很多用户（尤其是初学者）一直停留在AC5，没有动力去迁移。为了加速生态迁移，从MDK v5.37开始，安装包默认只包含ARM Compiler 6。那个我们熟悉的“ARM Compiler 5”选项，在全新的安装环境中，变成了一个“幽灵”，工程指向它，但系统里却找不到它，于是就有了那个“is not available”的报错。

这有点像操作系统不再内置老版本的运行库。对于新启动的项目，直接使用AC6是最好的选择。但对于维护历史项目、编译第三方老库，AC5暂时还是无法完全绕开的。理解了这个背景，我们就知道，解决方案的核心就是：要么让工程改用已有的AC6，要么把“消失”的AC5给找回来并安装上。

2.3 报错信息的准确解读

让我们再仔细看一眼报错信息：*** target ‘target 1‘ uses arm-compiler ‘default compiler version 5‘ which is not available.

• target 1: 这是Keil工程中的一个“目标”（Target），一个工程可以包含多个Target，例如调试版本、发布版本等。通常默认只有一个Target 1。
• arm-compiler ‘default compiler version 5‘: 这明确指出，当前这个Target的配置中，选择的ARM编译器是“版本5”。
• which is not available: 关键就在这里。Keil软件在它已知的编译器安装路径下，没有找到版本5的编译器套件。

所以，解决路径非常清晰：1) 改变Target的配置，换一个可用的编译器；2) 安装一个可用的“版本5”编译器。

3. 解决方案一：修改工程配置，迁移至ARM Compiler 6（推荐方案）

这是最面向未来的解决方案，尤其适合你打算长期维护这个项目，或者这是一个新项目。它的好处是一劳永逸，直接使用最新的工具链。

3.1 配置修改步骤详解

1. 打开工程选项：在Keil中，点击工具栏的魔术棒图标（Options for Target），或者右键点击左侧Project窗口中的Target名称，选择“Options for Target ‘Target 1’”。

2. 切换到‘Target’选项卡：你会看到一个关于处理器内核、ROM/RAM地址的配置界面。这里需要注意一个关键点：确保‘Code Generation’区域中的‘ARM Compiler’下拉框不是灰色不可用的。如果它显示为Use default compiler version 5且不可编辑，说明这个配置被工程模板锁定了。

3. 解除编译器锁定（关键步骤）：如果编译器选项不可选，你需要先切换到“Device”选项卡，确认你选择的芯片型号是正确的。然后，最重要的一步：点击“OK”或“Cancel”关闭Options对话框。接着，在左侧Project窗口中，右键点击你的Target（如‘Target 1’），选择‘Manage Project Items…’。在弹出的对话框中，切换到“Folders/Extensions”选项卡。看最下方“Use ARM Compiler”的选项，将其从“Use default compiler version 5”改为“Use default compiler version 6”或者“Use ARM Compiler 6”。点击OK。这个操作是解除工程级编译器锁定的关键。

4. 重新选择编译器：再次打开“Options for Target”。现在，“Target”选项卡下的“ARM Compiler”下拉框应该可以选择了。将其从“Use default compiler version 5”修改为“ARM Compiler 6”。

5. 处理可能出现的编译错误：点击“OK”保存配置后，立即尝试编译。很大概率会失败，并出现一堆新的错误。这才是真正的挑战。常见的AC5到AC6的迁移错误包括：

   • 内联汇编语法不兼容：AC6使用了更严格的Clang风格内联汇编格式。例如，AC5中__asm void WFI(void) { WFI }在AC6中需要改为void WFI(void) { __asm(“WFI”); }。你需要找到工程中所有的内联汇编（通常在启动文件startup_xxx.s或一些底层驱动里），按照AC6的语法进行修改。一个更简单的方法是，去芯片厂商官网下载基于AC6的最新版Device Family Pack（DFP）或HAL库，用里面提供的AC6格式的启动文件替换掉老的。
   • 链接脚本（.sct文件）语法警告：AC6对分散加载文件的语法检查更严格，可能会对一些老的符号定义报警告，通常不影响功能，但可以参照AC6的文档进行微调。
   • 编译器预定义宏变化：某些代码可能通过#ifdef __CC_ARM（这是AC5的标识）来区分编译器。AC6对应的宏是__ARMCC_VERSION，且其值大于6000000。你需要更新这些条件编译的代码。

注意：直接修改启动文件等底层代码有风险。最佳实践是，优先从芯片厂商的官网获取针对AC6优化过的设备支持包和例程，用它们提供的文件来替换你工程中的对应文件。这是最安全、最规范的方式。

3.2 方案一实操心得与评估

优点：

• 一劳永逸，享受AC6更快的编译速度和更好的代码优化。
• 符合工具链发展趋势，便于后续使用更新的芯片和库。
• 无需安装额外的组件，保持开发环境简洁。

缺点与挑战：

• 迁移成本高：对于复杂的老工程，特别是大量使用内联汇编或冷门编译器特性的，修改工作量可能很大。
• 第三方库兼容性：如果你工程中使用了编译好的、仅支持AC5的静态库（.lib或.a文件），那么切换到AC6后将无法链接，必须找到源码重新用AC6编译，或者寻找AC6版本的库。
• 调试体验微调：AC6生成的调试信息格式与AC5略有不同，在极少数情况下可能需要微调调试配置。

我的建议：对于个人学习、新项目、或者你有源码控制权且结构相对简单的老项目，强烈推荐优先尝试此方案。虽然开头可能会遇到一些编译错误，但解决的过程能让你更深入地理解代码和工具链，是很好的学习机会。对于企业内庞大而稳定的遗产项目，则需要评估迁移风险和收益。

4. 解决方案二：独立安装ARM Compiler 5（兼容性方案）

如果你的项目非常庞大，迁移困难，或者严重依赖仅支持AC5的二进制库，那么“找回”ARM Compiler 5是最直接、破坏性最小的方案。

4.1 如何获取和安装ARM Compiler 5

ARM Compiler 5并没有消失，它只是不再被默认包含在Keil MDK的安装包里。你需要单独安装它。

1. 官方途径获取：

   • 访问ARM官方网站的开发者页面，在下载区域寻找“ARM Compiler 5”或“ARM Compiler 6”的独立安装包。ARM有时会将它们打包在一起。
   • 更常见的方法是，找到一份Keil MDK 5.36或更早版本的安装包。在安装过程中，选择自定义安装，你可以看到并选择安装“ARM Compiler 5”。安装完成后，其路径通常位于C:\Keil_v5\ARM\ARMCC或类似位置。

2. 安装与Keil集成：独立安装的ARM Compiler 5通常是一个独立的安装程序。安装时，最好将其安装到你的Keil MDK 5.37的根目录下，例如C:\Keil_v5\ARM\ARMCC。这样Keil更容易自动识别它。如果安装到了其他路径，也没关系，我们可以手动告诉Keil它的位置。

3. 在Keil中配置编译器路径：

   • 打开Keil 5.37，点击菜单栏的Project->Manage->Project Items，或者点击工具栏的“文件夹与书本”图标（Manage Project Items）。
   • 在弹出的对话框中，切换到“Folders/Extensions”选项卡。
   • 你会看到一个“Use ARM Compiler”的下拉列表。如果此时下拉列表里已经有了“ARM Compiler 5”的选项，说明Keil已经自动找到了。如果没有，你需要手动添加。
   • 点击下拉列表右侧的“...”按钮，会打开一个“Environment Configuration”对话框。
   • 在这里，你可以添加、删除或修改工具链的路径。点击“Add”按钮，然后浏览到你安装ARM Compiler 5的bin目录（例如C:\Keil_v5\ARM\ARMCC\bin）。添加后，为其起一个名字，比如“ARMCC v5.06”。
   • 保存设置后，回到工程选项（魔术棒）的“Target”选项卡，现在“ARM Compiler”下拉列表中就应该出现你刚添加的“ARMCC v5.06”选项了，选择它即可。

4.2 方案二实操心得与评估

优点：

• 改动最小：无需修改任何工程代码，完美兼容老项目。
• 风险最低：编译行为与之前完全一致，避免了因工具链变更引入的难以排查的新问题。
• 适合团队协作：当团队其他成员仍在使用旧版Keil时，可以保证工程配置的统一。

缺点：

• 环境复杂化：你需要管理两套编译器，增加了开发环境配置的复杂度。
• 未来兼容性：ARM已经停止对AC5的功能更新，只有关键的安全补丁。长期来看，它终将被淘汰。
• 可能存在的许可问题：确保你使用的ARM Compiler 5版本是合法的，拥有相应的许可证。

我的建议：这是解决遗留项目编译问题的“特效药”。如果你只是想快速编译运行一个下载的老例程，或者紧急修复一个生产线上老项目的Bug，这是最高效的方式。安装时，尽量使用从ARM官方或Keil历史版本中提取的干净安装包，避免来源不明的修改版，以保证稳定性。

5. 解决方案三：修改工程模板的默认编译器配置（治本方案）

我们遇到的报错，根源在于工程模板（.uvprojx或.uvmpw文件）里写死了一行配置：<TargetOption> <TargetCommonOption> <ArmClang>Use default compiler version 5</ArmClang>。方案一是“改工程”，方案二是“补环境”，而方案三是“改模板”，防止新建的工程也出现同样问题。

5.1 理解工程模板与默认设置

当你通过Keil的“New Project”向导创建工程，选择芯片型号后，Keil会用一个对应的模板文件来初始化你的工程。这个模板文件决定了工程的初始配置，包括默认的编译器。在Keil 5.37中，这些模板文件可能还没有更新，仍然指向不存在的“default compiler version 5”。

5.2 修改模板文件步骤

警告：此操作涉及修改Keil的系统文件，操作前建议备份相关文件。

1. 找到模板文件：Keil的设备数据库和模板文件通常位于C:\Keil_v5\ARM\PACK目录下，各个芯片厂商的包（.pack文件）解压后存放在这里。但更直接的方法是修改用户目录下的模板。在Keil中，点击File->Manage->Project Items，在“Folders/Extensions”选项卡里，可以看到“Template”的路径。通常会在用户文档目录下，如C:\Users\你的用户名\AppData\Local\Arm\Packs\Keil\...。找到这些.uvprojx或.uvmpw文件比较繁琐。

2. 一个更实用的技巧：创建“正确”的新工程作为模板。

   • 打开Keil 5.37，创建一个全新的工程，选择你的目标芯片。
   • 工程创建后，立即按照方案一的步骤，将工程的默认编译器改为“ARM Compiler 6”，并处理好可能的基础配置（比如正确的启动文件）。
   • 将这个配置正确的工程另存为一个模板：点击Project->Save Project as Template...。给它起个名字，比如“MyTemplate_AC6”。
   • 以后新建工程时，不要使用默认向导，而是点击Project->New Project from Template...，然后选择你刚才保存的“MyTemplate_AC6”。这样创建出来的工程，默认就是使用AC6的，从根本上避免了报错。

3. 直接编辑模板文件（高级）：如果你熟悉XML格式，可以找到默认的模板文件（.uvprojx是XML格式），用文本编辑器打开，搜索<ArmClang>Use default compiler version 5</ArmClang>，将其改为<ArmClang>ARM Compiler 6</ArmClang>。但鉴于文件路径复杂且可能随更新变化，方法2是更安全、更推荐的做法。

5.3 方案三实操心得与评估

优点：

• 一劳永逸：一次配置，之后所有新建工程都默认正确，无需重复操作。
• 提升效率：特别适合需要频繁创建新项目（如教学、评估不同芯片）的场景。
• 团队标准化：可以将配置好的模板分享给团队成员，统一开发环境起点。

缺点：

• 操作有一定门槛：需要理解工程模板的概念，并且初始的AC6工程配置可能需要一些调试。
• 不解决已有老工程：这个方法只对新建工程有效，已有的老工程还是需要用方案一或方案二来解决。

我的建议：如果你决定全面拥抱ARM Compiler 6，那么在解决完一两个示例工程的迁移问题后，立刻花时间创建一个属于自己的、配置完善的AC6工程模板，这是极具长期价值的投资。它能让你未来的开发工作有一个干净、正确的起点。

6. 编译问题深度排查与进阶技巧

解决了编译器缺失这个主要矛盾后，在编译过程中你可能还会遇到其他相关问题。这里分享一些深度排查技巧和常见误区。

6.1 编译器版本选择背后的细节

在“Options for Target” -> “Target”选项卡下，点击“ARM Compiler”下拉框，你可能会看到好几个选项：

• Use default compiler version 5/6: 这是使用Keil全局设置的默认版本。
• ARM Compiler 5 (default compiler version 5): 明确的AC5。
• ARM Compiler 6 (ARMCLANG): 明确的AC6。
• 还可能有一些具体的子版本号，如ARM Compiler 5.06 update 7。

最佳实践是永远不要选择“Use default compiler version X”这种模糊的选项。因为“default”可能随着Keil版本更新或全局设置改变而变化，导致工程行为不可预测。明确指定一个具体的编译器版本，如“ARM Compiler 6”或你安装的特定AC5版本，这样才能保证工程在任何人的电脑上、在任何时候编译行为都一致。这是工程可重现性的关键。

6.2 头文件路径与编译器兼容性

切换编译器后，一个隐蔽的问题是头文件路径。AC5和AC6的核心头文件位置可能不同。如果编译时出现“找不到头文件”的错误，你需要检查：

1. “Options for Target” -> “C/C++”选项卡下的“Include Paths”：确保这里包含了所有必要的头文件目录。这些路径通常是相对路径，切换编译器后一般不需要改。
2. 预处理宏（Preprocessor Symbols）：有时代码会通过宏来判断编译器。确保这里定义的宏对于AC6是正确的。例如，AC6可能需要定义__ARMCC_VERSION相关的宏，而AC5是__CC_ARM。

6.3 链接器与运行时库（MicroLib）的配置

在“Target”选项卡中，有一个重要的选项叫“Use MicroLIB”。这是一个为嵌入式系统优化的精简C库。

• AC5与MicroLIB：配合良好，是很多资源紧张项目的默认选择。
• AC6与MicroLIB：同样支持，但有时在实现细节上可能有差异。如果你从AC5切换到AC6后，程序运行出现异常（如printf不输出、内存操作错误），可以尝试取消勾选“Use MicroLIB”，使用标准的C库（ARM Compiler Runtime）试试。标准库更强大，但生成的代码体积会大一些。

6.4 关于“ARM Compiler 5.06 update 7”等特定版本

网络搜索中经常出现“ARM Compiler 5.06 update 7”这个具体版本号。这是ARM Compiler 5的一个特定更新版本，修复了一些Bug并可能包含最后的功能更新。如果你需要安装AC5，寻找这个版本是一个不错的选择，因为它相对成熟稳定。安装后，在Keil的编译器下拉列表中，它可能会显示为一个带具体版本号的选项，选择它即可。

7. 总结与最终行动指南

面对Keil 5.37的“*** target ‘target 1‘ uses arm-compiler ‘default compiler version 5‘ which is not available”报错，我们已经有了从表面到深层、从临时到永久的全套解决方案。现在，让我们梳理一个清晰的决策和行动流程：

第一步：诊断与决策

• 打开报错工程，进入“Options for Target” -> “Target”。
• 观察“ARM Compiler”是否被锁定为灰色。如果是，按前文所述先解除锁定。
• 评估项目：这是一个必须长期维护的核心项目吗？它有大量难以修改的AC5特定代码或二进制库吗？
  • 是-> 优先选择方案二（安装ARM Compiler 5），快速恢复编译。
  • 否（新项目、学习项目、你有完整源码且结构清晰）-> 优先选择方案一（迁移至ARM Compiler 6）。

第二步：执行解决方案

• 选择方案一：做好心理准备，会遭遇一些编译错误。按照第3部分的步骤，逐个解决内联汇编、链接脚本等问题。善用芯片厂商官网的最新库和示例代码。
• 选择方案二：寻找Keil MDK 5.36或更早的安装包，或从ARM官网下载独立AC5安装包。安装后，务必在Keil的“Manage Project Items” -> “Folders/Extensions”中确认编译器已被正确识别和添加。

第三步：固化与优化（长期建议）

• 无论采用哪种方案解决了当前项目，都强烈建议你执行方案三：为自己创建一个配置正确的工程模板。如果你选择了AC6，就创建一个AC6的模板；如果团队仍需AC5，就创建一个AC5的模板。这将为你节省未来无数的时间。
• 在工程配置中，永远明确指定具体的编译器版本，而不是使用“default”选项。
• 定期关注ARM和Keil的更新，了解工具链的发展动态。对于新项目，毫无悬念地应该从ARM Compiler 6开始。

这个报错虽然令人烦恼，但它恰恰是技术演进中的一个标志性节点。理解并解决它，不仅是为了让眼前的代码跑起来，更是为了让你对嵌入式开发的工具链生态有更深刻的把握。工具在变，但解决问题的思路是相通的：定位根因、评估选项、选择最适合当前场景的路径、并思考如何优化未来的工作流。希望这篇超详细的拆解，能帮你彻底驯服这只Keil 5.37带来的“拦路虎”。