设置Visual Studio

虚幻引擎（简称UE） 能与 Visual Studio（简称VS） 完美结合，使你能够快速、简单地改写项目代码，并能即刻查看编译结果。设置Visual Studio以使用虚幻引擎能提高开发者对虚幻引擎的利用效率和整体用户体验。

该文档介绍如何建立从虚幻引擎到Visual Studio的基本工作流程。

版本兼容性

下列表格列出了已集成二进制版虚幻引擎的Visual Studio版本。

在UE 5.1中， 虚幻构建工具（Unreal Build Tool (UBT)） 能够为最新安装版本的Visual Studio生成Visual Studio解决方案文件，除非你安装了不支持最新版本的平台SDK。在这种情况下，UBT会为支持该平台SDK的最新版本Visual Studio生成解决方案文件。

对于UE5.2，VS2022是用于编译虚幻引擎的默认Visual Studio版本。

如果你想为UE5.2预编译插件，我们推荐你使用VS2019进行编译。这能让所有UE5.2的用户都能使用你的插件，无论他们使用的是VS 2019还是VS 2022。关于插件的更多信息，请参阅插件文件。

UE 5.4将不再支持Visual Studio 2019，而是需要使用Visual Studio 2022。

运行虚幻引擎必备条件安装程序

在Epic启动器安装或从GitHub复制虚幻引擎时，将自动运行虚幻引擎必备条件安装程序。若通过Perforce进行安装或同步虚幻引擎，则需要手动运行必备条件安装程序。运行本地编译的虚幻引擎工具前必须进行此操作。安装程序位于 虚幻引擎根目录\Engine\Extras\Redist\en-us\ 。

新安装Visual Studio时的选项

如果你是初次安装Visual Studio，请确保启用下列选项。

Visual Studio工作负载

使用VS进行虚幻引擎开发需要安装以下可选的 工作负载 ：

• .NET桌面开发
• 使用C++的桌面开发
• 通用Windows平台开发
• 使用C++的游戏开发

C++工具

要在安装Visual Studio时添加C++工具，请确保在 工作量（Workloads） 下选择 用C++开发游戏（Game development with C++） ，并使用以下选项：

• C++分析工具
• C++ AddressSanitizer（可选）
• Windows 10 SDK（10.0.18362或更高版本）
• 虚幻引擎安装程序

推荐设置

以下是使用Visual Studio和虚幻引擎的开发者的推荐设置。

假如下方的VS版本看上去有些陌生，那是因为主题改成了 深色调 。方法是，打开 工具（Tools） > 选项（Options） > 环境（Environment） > 常规（General） > 颜色主题（Color theme） 。

增加解决方案配置下拉菜单的宽度

1. 启动VS。如果你是第一次打开VS，会弹出 快速入门（Get Started） 窗口。点击 不添加代码继续（Continue without code） 。

   点击查看大图。

2. 右键点击工具栏，选择弹出菜单底部的 自定义（Customize） 。

   点击查看大图。

3. 点击 命令（Commands） 选项卡并选择 工具栏（Toolbar） 单选按钮。
   

4. 在 工具栏（Toolbar） 旁边的下拉菜单中，选择 标准（Standard） 。
   

5. 在 预览（Preview） 列表中，选择 解决方案配置（Solution Configurations） 功能按钮（你可能需要向下滚动），然后点击右侧的 修改选项（Modify Selection） 。

6. 将 宽度（Width） 设置为 200 ，然后点击 确定（OK） 。
   

7. 点击 自定义（Customization） 上的 关闭（Close） 。你的工具栏应该会立刻更新。

添加解决方案平台下拉菜单

1. 找到 标准（Standard） 工具栏最右侧的按钮（若将光标悬停在此处，将显示 标准工具栏选项（Standard Toolbar Options） ）。

2. 点击下拉按钮，选择 添加或移除按钮（Add or Remove Buttons） ，然后点击 解决方案平台（Solution Platforms） ，将菜单添加到工具栏中（此步骤可能已经默认完成）。

关闭错误列表窗口

通常情况下，若代码出错，会自动弹出错误列表（Error List） 。但使用虚幻引擎时，错误列表窗口会误报错误信息。建议在使用虚幻引擎时，禁用错误列表窗口，并使用 输出（Output） 窗口查看实际代码错误。以下是关闭错误列表窗口的步骤。

1. 若已打开 错误列表（Error List） 窗口，先请关闭。

2. 在 工具（Tools） 菜单中打开 选项（Options） 对话框。
   

3. 选择 项目和解决方案（Projects and Solutions） 并禁用 编译出错时始终显示错误列表（Always show Error List if build finishes with error） 。
   

4. 点击 确定（OK） 。

以下是其他一些可能有用的配置设置：

• 关闭 显示非活跃代码块（Show Inactive Blocks） 。如不关闭，文本编辑器中的很多代码块将变灰。前往 工具 > 选项 > 文本编辑器 > C/C++ > 视图） 关闭此设置

• 设置 禁用外部依赖性文件夹 为 True ，以在 解决方案浏览器（Solution Explorer） 中隐藏不必要的文件夹。在 工具 > 选项 > 文本编辑器 > C/C++ > 高级 中找到 禁用外部依赖项性文件夹 。

• 关闭 编辑并继续（Edit & Continue） 功能，无需使用。前往 工具 > 选项 > 调试（Debugging） > 编辑并继续（Edit and Continue） 。

• 打开 智能提示（IntelliSense） 。