当前位置：首页 > news >正文

QtCreator+CMake构建报jom Error 2？别慌，手把手教你配置MSVC环境变量（附rc.exe、mt.exe路径查找）

news 2026/6/13 20:19:32

QtCreator+CMake构建报jom Error 2？手把手教你配置MSVC环境变量

第一次在Windows上用QtCreator配合CMake和MSVC工具链构建项目时，看到控制台突然蹦出jom Error 2的红色错误提示，相信不少开发者都会心头一紧。这种报错往往伴随着一堆晦涩的路径信息和找不到文件的提示，让刚接触这套工具链的新手感到无从下手。实际上，这个问题通常并不是代码本身的问题，而是环境变量配置不完整导致的工具链断裂。

1. 理解jom Error 2背后的真实原因

当你在QtCreator中点击构建按钮后，整个构建过程其实经历了一系列隐藏的步骤。CMake首先会进行环境检测，验证所有必要的工具是否可用。这个阶段如果失败，就会出现jom Error 2，而项目源文件甚至都还不会被加载到IDE中。

查看详细的错误日志，通常会看到类似这样的关键信息：

RC Pass 1: command "rc /fo CMakeFiles\cmTC_5b162.dir/manifest.res CMakeFiles\cmTC_5b162.dir/manifest.rc" failed (exit code 0) with the following output: 系统找不到指定的文件。

或者

--mt=CMAKE_MT-NOTFOUND

这两个线索直接指向了问题的核心：

rc：指的是Windows资源编译器rc.exe，用于处理程序资源文件
mt：指的是清单工具mt.exe，用于处理程序清单文件

当这些工具不在系统PATH环境变量中时，CMake就无法定位它们，进而导致整个构建过程失败。而jom（Qt自带的并行构建工具）只是忠实地报告了这个错误，它本身并不是问题的根源。

2. 定位必备工具的实际路径

2.1 找到jom.exe的正确位置

虽然jom不是问题的根源，但确保它在PATH中也是个好习惯。jom通常位于Qt安装目录下的Tools子文件夹中：

${Qt安装目录}\Tools\QtCreator\bin

例如，如果你将Qt安装在C:\Qt，那么完整路径可能是：

C:\Qt\Tools\QtCreator\bin

2.2 定位Windows SDK中的rc.exe和mt.exe

这两个关键工具位于Windows SDK的安装目录中，路径结构通常如下：

C:\Program Files (x86)\Windows Kits\10\bin\<SDK版本号>\<平台>

其中：

<SDK版本号>：如10.0.19041.0、10.0.17763.0等，取决于你安装的Windows SDK版本
<平台>：x86或x64，取决于你的目标平台

实际查找步骤：

打开文件资源管理器，导航到C:\Program Files (x86)\Windows Kits\10\bin
你会看到一个或多个以版本号命名的文件夹，选择最新的或与你项目匹配的版本
进入对应版本文件夹后，根据你的目标平台选择x86或x64子文件夹
确认该文件夹下存在rc.exe和mt.exe

表：不同Windows版本下SDK工具的典型路径

Windows版本	典型SDK版本	32位工具路径	64位工具路径
Windows 10	10.0.19041.0	`...\10.0.19041.0\x86`	`...\10.0.19041.0\x64`
Windows 11	10.0.22000.0	`...\10.0.22000.0\x86`	`...\10.0.22000.0\x64`

提示：如果你不确定安装了哪些SDK版本，可以在开始菜单中搜索"Windows SDK"查看已安装的版本。

3. 配置系统环境变量的正确方法

知道了工具的位置后，我们需要将这些路径添加到系统的PATH环境变量中。以下是详细步骤：

3.1 添加jom路径

右键点击"此电脑"，选择"属性"
点击"高级系统设置" → "环境变量"
在"系统变量"部分找到并选中"Path"，点击"编辑"
点击"新建"，添加jom所在的完整路径（如C:\Qt\Tools\QtCreator\bin）
点击"确定"保存

3.2 添加Windows SDK工具路径

继续在Path环境变量中：

再次点击"新建"
添加你找到的包含rc.exe和mt.exe的路径（如C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64）
如果你同时开发32位和64位程序，可能需要添加两个平台的路径
点击"确定"保存所有更改

3.3 验证环境变量配置

为了确保环境变量已正确设置：

打开新的命令提示符（重要：必须重新打开，环境变量更改不会自动应用到已打开的终端）
分别运行以下命令验证工具是否可用：

where jom where rc where mt

每个命令都应该返回对应工具的完整路径。如果没有，请检查路径是否正确添加。

4. 在QtCreator中验证配置

完成环境变量配置后，需要确保QtCreator能够感知这些更改：

完全退出QtCreator（包括所有后台进程）
重新启动QtCreator
打开你的CMake项目
尝试重新构建项目

如果一切配置正确，之前的jom Error 2应该已经消失，项目可以正常构建了。

5. 常见问题排查

即使按照上述步骤操作，有时仍可能遇到问题。以下是一些常见情况及解决方法：

5.1 仍然找不到rc.exe或mt.exe

可能原因1：添加了错误的SDK版本路径
- 解决方案：检查项目中使用的工具链版本，确保添加了匹配的SDK路径
可能原因2：32位/64位不匹配
- 解决方案：如果你构建的是64位项目，确保添加的是x64路径，反之亦然
可能原因3：环境变量未正确应用
- 解决方案：重启计算机确保所有环境变量更改完全生效

5.2 构建成功但运行时出现问题

有时构建能通过，但运行程序时出现MSVC运行时库缺失的错误。这通常是因为：

缺少VC++ Redistributable
环境变量中缺少DLL搜索路径

解决方法：

# 将VC工具链路径添加到PATH C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.29.30133\bin\Hostx64\x64

注意：具体路径中的版本号（14.29.30133）会根据你安装的VS版本而变化。

5.3 多版本Qt和VS共存时的冲突

如果你安装了多个版本的Qt和Visual Studio，可能会遇到工具链混乱的问题。建议：

在QtCreator的"工具"→"选项"→"Kits"中明确指定每个构建套件使用的工具链
为不同项目使用匹配的Qt版本和MSVC版本
考虑使用vcvarsall.bat脚本为特定项目设置环境

# 使用vcvarsall初始化特定MSVC环境 call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" x64

6. 进阶配置建议

为了让开发环境更加稳定可靠，可以考虑以下优化：

6.1 创建构建脚本

为了避免每次都需要手动设置环境变量，可以创建构建脚本：

@echo off set PATH=C:\Qt\Tools\QtCreator\bin;%PATH% set PATH=C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64;%PATH% set PATH=C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.29.30133\bin\Hostx64\x64;%PATH% qtcreator.exe

6.2 使用CMake预设

在CMakePresets.json中预先配置好生成器和其他参数：

{ "version": 3, "configurePresets": [ { "name": "msvc", "displayName": "MSVC Configuration", "generator": "NMake Makefiles JOM", "binaryDir": "${sourceDir}/build", "environment": { "PATH": "$env{PATH};C:/Program Files (x86)/Windows Kits/10/bin/10.0.19041.0/x64" } } ] }