必须避开默认路径陷阱、组件缺失和权限冲突三类高频失败点:取消Launcher快捷方式勾选、安装路径禁用中文空格、关闭Windows长路径限制、VS2022须勾选MSVC v143及CMake工具、UE5.4与Launcher路径分离且启用源码与资产库。

要在Windows系统上安装Unreal Engine虚幻引擎来开发3A级大作,必须避开默认路径陷阱、组件缺失和权限冲突这三类高频失败点——很多开发者卡在“启动器能开但装不了引擎”或“装完打不开项目”,根源往往出现在Visual Studio工作负载没选全、安装路径含中文空格、或Windows长路径限制未关闭。
下载并配置Epic Games Launcher
访问 https://www.epicgames.com/store/zh-CN/download,点击“获取Epic Games”下载官方安装包EpicInstaller-6.1.0.msi;不要从第三方站点下载,否则可能触发签名验证失败导致后续无法更新引擎版本。
双击运行安装包,【务必取消勾选“将Epic Games Launcher添加到开始菜单”和“创建桌面快捷方式”】——这两项会强制写入C:\Program Files目录,而UE5编译时若检测到路径含空格或系统保护目录,会静默跳过部分头文件生成,导致新建C++项目后立即报错“Cannot find UnrealBuildTool”。
安装路径手动改为 D:\EpicGames(或任意非系统盘根目录),一路下一步完成安装。首次启动时,若弹出UAC提示,直接点“否”,避免以管理员身份运行——这会导致后续VS集成失败。
注册账号并登录启动器
打开Epic Games Launcher,在登录页点击“注册”,用真实邮箱注册账户;注意邮箱需未被其他Epic账号绑定,否则会提示“该邮箱已被使用”且无找回入口。
注册完成后返回登录页,输入账号密码登录。若登录界面卡在加载状态,关闭启动器,进入 D:\EpicGames\Launcher\Portal\Binaries\Win64,右键 EpicGamesLauncher.exe → 属性 → 兼容性 → 勾选“以兼容模式运行” → 选择“Windows 8”,再启动即可绕过TLS握手超时问题。
安装UE5最新稳定版(以UE5.4为例)
登录成功后,点击左上角“启动”按钮 → 切换到“虚幻引擎”选项卡 → 点击右上角“+”号 → 在下拉列表中选择 UE5.4(当前最新LTS版本,含完整Nanite/Lumen支持)→ 点击“安装”。
安装路径必须与Launcher路径分离:例如Launcher装在 D:\EpicGames,则UE5.4建议装在 E:\UE_5.4;【路径中严禁出现中文、空格、括号、点号(如“v5.4.”)、波浪号(~)】,否则在生成Visual Studio解决方案时会报错“Invalid character in project path”,且错误日志不提示具体非法字符位置。
勾选“安装额外内容(免费资产库)”和“源代码(Source Code)”两项——做大作必须用源码调试,否则遇到渲染管线卡顿或蓝图崩溃无法定位C++层原因;资产库虽占约12GB空间,但Blockout环境、Quixel Bridge直连权限、MetaHuman基础模板都依赖它。
配置Visual Studio 2022社区版(必需)
方法一:通过Epic Launcher自动安装
在Launcher中切换到“附加”选项卡 → 找到“Visual Studio Community 2022” → 点击“安装”。此方式会自动勾选以下5项核心工作负载:
① 使用C++的桌面开发
② 游戏开发与C++
③ .NET桌面开发
④ Windows 11 SDK(版本10.0.22621或更高)
⑤ CMake工具用于Windows
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集,阿里云 ASR 实时识别。一键启动脚本,自动安装环境。
方法二:手动安装(推荐,可控性更强)
前往 https://visualstudio.microsoft.com/zh-hans/vs/community/ 下载VS2022社区版离线安装包;运行安装程序时,在“工作负载”页手动勾选上述5项,特别注意:MSVC v143工具集(x64)必须勾选,UE5.4默认不兼容v142;在“单个组件”页搜索并勾选“Git for Windows”和“CMake Tools for Visual Studio”。
安装完成后,重启Epic Games Launcher,进入“设置”→“通用”→ 滚动到底部,确认“Visual Studio”下拉框中已识别到VS2022实例;若显示“未找到”,说明VS安装路径被系统策略重定向,需手动点击“浏览”指向 C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\amd64\MSBuild.exe。
解除Windows长路径限制(关键步骤)
按下 Win+R,输入 gpedit.msc 回车 → 依次展开“计算机配置”→“管理模板”→“系统”→“文件系统”→ 双击“启用Win32长路径” → 选择“已启用” → 点击“确定”。
此操作必须在UE5安装前完成。若跳过,当项目含嵌套蓝图(如Character → AnimBP → StateMachine → BlendSpace)时,编译器会因路径长度超260字符截断符号链接,导致打包时报错“Failed to resolve reference: /Game/…”且无具体文件名提示。
执行命令提示符(管理员):fsutil behavior set LongPathsEnabled 1,确保注册表值生效。
验证安装并运行首个大作级项目
回到Epic Games Launcher → “虚幻引擎”→ 点击已安装的UE5.4右侧“启动”按钮旁的▼ → 选择“编辑器(Editor)”启动。
首次启动会弹出“设置默认编辑器”窗口,选择“Visual Studio 2022”并勾选“始终使用此编辑器”;接着弹出DDC(衍射数据缓存)初始化进度条,等待其完成(约3–5分钟),不要关闭窗口。
进入主界面后,点击“新建项目”→ 选择“游戏”→ “C++”→ 模板选“Blank”→ 勾选“启用初学者内容包”→ “目标平台”选“Desktop”→ “图形API”强制选“DirectX 12”→ 点击“创建”。
项目创建完成后,编辑器自动加载,顶部菜单栏点击“编辑”→“编辑器偏好设置”→ 左侧展开“源代码”→ 将“源代码编辑器”设为“Visual Studio 2022”→ 点击右上角“重新加载”按钮;此时右键任一C++类(如MyGameModeBase)→ “在Visual Studio中编辑”,应能正常跳转并高亮语法。

















