为虚幻引擎C++项目设置Visual Studio开发环境 | 虚幻引擎5.1文档 (unrealengine.com)
虚幻引擎(简称UE) 能与 Visual Studio(简称VS) 完美结合,使你能够快速、简单地改写项目代码,并能即刻查看编译结果。设置Visual Studio以使用虚幻引擎能提高开发者对虚幻引擎的利用效率和整体用户体验。
该文档介绍如何建立从虚幻引擎到Visual Studio的基本工作流程。
版本兼容性
下列表格列出了已集成二进制版虚幻引擎的Visual Studio版本。
虚幻引擎版本 |
Visual Studio版本 |
---|---|
5.1 或更高版本 |
VS 2019 (默认) / VS 2022 |
4.25 到 5.0 |
VS 2019 (默认) |
在UE 5.1中, 虚幻构建工具(Unreal Build Tool (UBT)) 能够为最新安装版本的Visual Studio生成Visual Studio解决方案文件,除非你安装了不支持最新版本的平台SDK。在这种情况下,UBT会为支持该平台SDK的最新版本Visual Studio生成解决方案文件。
运行虚幻引擎必备条件安装程序
在Epic启动器安装或从GitHub复制虚幻引擎时,将自动运行虚幻引擎必备条件安装程序。若通过Perforce进行安装或同步虚幻引擎,则需要手动运行必备条件安装程序。运行本地编译的虚幻引擎工具前必须进行此操作。安装程序位于 虚幻引擎根目录\Engine\Extras\Redist\en-us\
。
新安装Visual Studio时的选项
如果你是初次安装Visual Studio,请确保启用下列选项。
Visual Studio工作负载
使用VS进行虚幻引擎开发需要安装以下可选的 工作负载:
-
.NET desktop development
-
Desktop development with C++
-
Universal Windows Platform development
-
Game development with C++
C++工具
要在安装Visual Studio时添加C++工具,请确保在 工作量(Workloads) 下选择 用C++开发游戏(Game development with C++),并使用以下选项:
-
C++ profiling tools
-
C++ AddressSanitizer (optional)
-
Windows 10 SDK (10.0.18362 or Newer)
-
虚幻引擎安装程序
推荐设置
以下是使用Visual Studio和虚幻引擎的开发者的推荐设置。
假如下方的VS版本看上去有些陌生,那是因为主题改成了 深色调。方法是,打开 工具(Tools) > 选项(Options) > 环境(Environment) > 常规(General) > 颜色主题(Color theme)。
增加解决方案配置下拉菜单的宽度
-
启动VS。如果你是第一次打开VS,会弹出 快速入门(Get Started) 窗口。点击 不添加代码继续(Continue without code)。
-
右键点击工具栏,选择弹出菜单底部的 自定义(Customize)。
-
点击 命令(Commands) 选项卡并选择 工具栏(Toolbar) 单选按钮。
-
在 工具栏(Toolbar) 旁边的下拉菜单中,选择 标准(Standard)。
-
在 预览(Preview) 列表中,选择 解决方案配置(Solution Configurations) 功能按钮(你可能需要向下滚动),然后点击右侧的 修改选项(Modify Selection)。
-
将 宽度(Width) 设置为 200,然后点击 OK。
-
点击 自定义(Customization) 上的 关闭(Close)。你的工具栏应该会立刻更新。
添加解决方案平台下拉菜单
-
找到 标准(Standard) 工具栏最右侧的按钮(若将光标悬停在此处,将显示 标准工具栏选项(Standard Toolbar Options))。
-
点击下拉按钮,选择 添加或移除按钮(Add or Remove Buttons),然后点击 解决方案平台(Solution Platforms),将菜单添加到工具栏中(此步骤可能已经默认完成)。
关闭错误列表窗口
通常情况下,若代码出错,会自动弹出**错误列表(Error List)。但使用虚幻引擎时,错误列表窗口会误报错误信息。建议在使用虚幻引擎时,禁用错误列表窗口,并使用 输出(Output)** 窗口查看实际代码错误。以下是关闭错误列表窗口的步骤。
-
若已打开 错误列表(Error List) 窗口,先请关闭。
-
在 工具(Tools) 菜单中打开 选项(Options) 对话框。
-
选择 项目和解决方案(Projects and Solutions) 并禁用 编译出错时始终显示错误列表(Always show Error List if build finishes with error)。
-
点击 OK。
以下是其他一些可能有用的配置设置:
-
关闭 显示非活跃代码块(Show Inactive Blocks)。如不关闭,文本编辑器中的很多代码块将变灰。前往 工具 > 选项 > 文本编辑器 > C/C++ > 视图) 关闭此设置
-
设置 禁用外部依赖性文件夹 为 True,以在 解决方案浏览器(Solution Explorer) 中隐藏不必要的文件夹。在 工具 > 选项 > 文本编辑器 > C/C++ > 高级 中找到 禁用外部依赖项性文件夹。
-
关闭 编辑并继续(Edit & Continue) 功能,无需使用。前往 工具 > 选项 > 调试(Debugging) > 编辑并继续(Edit and Continue)。
-
打开 智能提示(IntelliSense)。