下载虚幻引擎源代码

源代码分支

Release Branch

Main Branch

下载源代码

Additional target platforms

许可和贡献

后续步骤

选择操作系统：

Windows

macOS

Linux

本页面为虚幻用户介绍了如何从 虚幻引擎（UE） 的GitHub仓库下载源代码，以及如何利用源代码快速上手。

如要访问https://github.com/EpicGames/UnrealEngine上的仓库，你必须满足以下条件：

已经是虚幻引擎的订阅用户。

已经拥有GitHub账号。

已经根据GitHub上的UE4一文中的所述步骤，将GitHub账号与你的虚幻引擎账号关联。

你 无需 下载源代码就能使用虚幻引擎4。如果你想通过下载可执行文件的方式来安装虚幻引擎，请参阅

你将获得Epic工程师每天（实际上是每一分钟）完成的最新功能和漏洞修复。

如果你发现了一个尚未被我们修复，但对你的项目来说影响很大的漏洞，你可以自己在源代码中进行修复并重新生成二进制文件，以便项目能够正常运行。

通过将你的修复工作提交给Epic，你可以改进引擎并为整个虚幻社区提供帮助。

如果你是虚幻引擎的授权用户，你可以通过我们的Perforce服务器访问源代码，而无需通过GitHub的公开仓库访问代码。

你应该已经注意到，我们已将UE5源代码发布在若干个分支中。

Branches whose names contain dev, staging, and test are typically for internal Epic processes, and are rarely useful for end-users Other short-lived branches may appear from time to time as we stabilize new releases or hotfixes.

The Release branch always reflects the current official release. These are extensively tested by our QA team, so they make a great starting point for learning Unreal Engine and for making your own projects. We work hard to make releases stable and reliable, and aim to publish a new release every few months.

Most active development on UE5 happens in the ue5-main branch. This branch reflects the latest release of the engine and may be buggy or it may not compile. We make it available for developers who are eager to test new features or work in lock-step development with us.

If you choose to work in this branch, be aware that it is likely to be ahead of the branches for the current official release and the next upcoming release. Therefore, content and code that you create to work with the ue5-main branch may not be compatible with public releases until we create a new branch directly from ue5-main for a future official release.

请按照如下说明下载虚幻引擎的源代码。

请确保你在Windows桌面系统中安装了Visual Studio 2019或更高版本的VS，然后再继续操作。

安装Windows版GitHub，然后分叉并克隆我们的仓库。

假如你想从命令行使用Git，请参阅设置Git以及分叉仓库等文档。

如果你不想用Git，你可以通过右侧的 '下载ZIP'（Download ZIP）按钮获取源代码。Windows内置的解压工具会将从网上下载的zip文件内容标记为不安全和不宜执行，因此请右键单击zip文件，并选择 '属性...' 和 '解锁'，然后再进行解压。第三方zip工具通常不需要进行此操作。

安装 Visual Studio 2019。

所有桌面版Visual Studio 2019都可以构建UE5，包括Visual Studio Community 2017，这是面向小型团队和个人开发者免费提供的工具。 请确保作在安装中添加C++支持，这在默认情况下是禁用的。

在资源管理器中打开你的源代码文件夹，并运行 Setup.bat。

这样将下载引擎的二进制内容和先决程序，并设置虚幻文件关联。 在Windows 8上，可能会显示SmartScreen警告。请依次单击 更多信息 和 Run anyway 以继续。

引擎二进制文件的完整下载包需要一些时间才能完成下载。 后续检出只需要下载增量部分，速度将会大幅提高。

运行 GenerateProjectFiles.bat 来为引擎创建项目文件。这个过程应该不超过一分钟即可完成。

双击 UE5.sln 文件以将项目加载到Visual Studio中。将你的解决方案配置设置为 开发编辑器，将解决方案平台设置为 Win64，然后右键单击 UE 目标并选择 构建。大概需要10-40分钟完成编译，具体取决于系统规格。

编译完成后，可以将启动项目设置为 UE5 并按 F5 进行调试，以便从Visual Studio加载编辑器。

安装一个Git客户端，例如Mac版GitHub，然后Fork并复制仓库。

如需在终端使用Git，请参阅文章设置Git和Fork仓库。 若不想使用Git，请点击右边的 '下载ZIP（Download ZIP）' 即可直接获得源代码。

安装最新版本的Xcode。

在访达（Finder）中打开源文件夹，双击 Setup.command 下载引擎的二进制内容。之后可以关闭终端窗口。

如果将源代码以.zip格式下载，则可能会弹出警告，称其来自无法识别的开发者（因为GitHub上的.zip文件未进行数字签名）。 解决方法是右键点击Setup.command、选择Open，然后点击 打开（Open） 按钮。

在同一个文件夹中双击 GenerateProjectFiles.command。这一步操作应不会长于一分钟时间。

双击 UE5.xcworkspace 文件将项目加载到Xcode中。在标题栏中选择 My Mac 目标的 ShaderCompileWorker，然后选择 '产品（Product） > 编译（Build）' 菜单项。Xcode完成编译后，为 My Mac 目标和 UE5 执行相同操作。编译时间可能在15到40分钟之间，具体取决于你的系统配置。

编译完成后，选择 '产品（Product） > 运行（Run）' 菜单项目来加载编辑器。

我们的开发人员和支持团队目前使用最新版本的Ubuntu；因此，我们可能无法对其他Linux发布版本（包括其他版本的Ubuntu）提供支持。

安装visual Git客户端并Fork仓库。 如果你倾向于不使用Git，请可使用右侧的 下载ZIP（Download ZIP）按钮来获取zip文件格式的源代码。

打开源代码文件夹，并运行 Setup.sh 以下载引擎的二进制内容。

交叉编译和原生构建均受支持。

如果你使用Windows进行开发（我们同时计划支持Mac开发），并想要针对Linux平台打包游戏，而且希望尽量减少问题，则 交叉编译（Cross-compiling） 是较为合适的选择，这要求你安装交叉编译工具链（请参阅wiki上的Linux交叉编译页面）。

关于 原生编译（Native compilation） 请参见单独的README文件。

本页面为被许可用户展示了如何从GitHub上的源代码仓库下载并构建虚幻引擎。如果你想下载二进制版本的虚幻引擎，请阅读我们的安装虚幻引擎文档了解如何获取虚幻。

Android support will be downloaded by the setup script if you have the Android NDK installed. See the Android Quick Start guide.

iOS development requires a Mac. Instructions are in the iOS Quick Start guide.

Development for consoles and other platforms with restricted access, like Sony PlayStation, Microsoft Xbox, and Nintendo Switch, is only possible if you have a registered developer account with those third-party vendors.

Depending on the platform, additional documentation or guidance may be available in the Unreal Developer Network support site, or as a downloadable archive in the section of the Unreal Engine Forums that is dedicated to your platform.

If you don't have access to these resources, first register a developer account with the third party vendor. Then contact your Epic Games account manager if you have one, or fill out and submit the Console Development Request form for Unreal Engine if you don't. Epic will contact you with a formal agreement to digitally sign. Once this is approved, you will receive instructions on how to access source code, binaries, and additional instructions for your platform.

你对GitHub上的Unreal Engine的访问和使用受虚幻引擎最终用户许可协议的约束。如果你不同意这些条款（我们会不时对它们加以修订），你将不会被获准访问或使用虚幻引擎。

我们欢迎你通过GitHub上的拉取请求，为虚幻引擎的开发做出贡献。我们大部分的积极开发都在 主 分支中进行，所以我们更喜欢在那里接受拉取请求（对于新功能而言尤其如此）。我们尽力确保所有新代码都遵守Epic编码标准。所有贡献均受EULA条款的约束。

现在你已经下载并设置了虚幻引擎，你可以随时

当你首次编译源代码并启动编辑器时，加载时间可能会比较长。 引擎会针对你的平台优化内容并将信息保存为 派生数据缓存（derived data cache），这种优化应该只会进行一次。

你为虚幻引擎代码设置的Fork分支会与你的GitHub账号权限关联。 如果你取消了订阅或切换了GitHub用户名，则需要重新创建Fork分支并从本地副本上传改动内容。