尝试重建Visual Studio文件遇错误:未找到32位编译器工具链
解决UnrealBuildTool找不到32位编译器的问题
这个问题我之前帮团队里的小伙伴处理过,核心原因是UnrealBuildTool默认在搜索VS2015(版本号14.0)的32位编译链,但你安装的是VS2017,路径自然对不上。结合你用Git协作、需要源码重建的场景,给你几个实用的解决步骤:
1. 让Unreal明确指定使用VS2017工具链
这是最简单的方案,优先试试:
- 打开Unreal编辑器后,点击顶部菜单栏的
Edit > Project Settings,在左侧导航栏找到Platforms > Windows - 在右侧的「Toolchain」下拉菜单里,选择「Visual Studio 2017」,保存设置后重启编辑器再尝试重建
- 如果是通过命令行执行构建,可以在命令里加上指定参数:
(如果项目确实需要32位,把UnrealBuildTool.exe <你的项目名> Win64 Development -Toolchain=VisualStudio2017Win64改成Win32就行)
2. 手动修改UnrealBuildTool的编译器路径(引擎源码版适用)
如果你是基于Unreal引擎源码进行开发,可以直接修改工具链配置:
- 找到引擎目录下的
Engine\Programs\UnrealBuildTool\Configuration\WindowsToolChain.cs文件 - 找到代码中指定VS安装路径的部分,把默认的
C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\bin\cl.exe替换成你VS2017的32位编译器路径,比如:
注意替换路径里的C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC\14.16.27023\bin\Hostx86\x86\cl.exe<版本号>(比如14.16.27023),你可以直接去C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC目录下查看具体的版本文件夹名
3. 安装VS2015兼容编译工具(兜底方案)
如果项目依赖必须使用VS2015的32位编译链,不用单独装VS2015,直接在VS2017里加组件就行:
- 打开VS2017的安装器,切换到「单个组件」标签页
- 搜索并勾选「MSVC v140 - VS 2015 C++生成工具」,点击「修改」完成安装。这样Unreal就能找到它需要的14.0版本32位
cl.exe了
4. 检查Git同步的项目本地配置
有时候团队项目的Git仓库里可能包含了本地配置文件,导致硬编码了VS版本:
- 找到项目目录下的
Saved\Config\Windows\Engine.ini文件 - 搜索
WindowsPlatformToolchain字段,如果值是VisualStudio2015,把它改成VisualStudio2017,保存后再尝试构建
内容的提问来源于stack exchange,提问作者Miika P.
相关产品推荐
相关产品推荐

