当前位置：首页 > article >正文

第 1 天：UE5 C++ 开发环境搭建，全流程指南

article 2025/2/3 12:18:20

🎯 目标：搭建 Unreal Engine 5（UE5）C++ 开发环境，配置 Visual Studio 并成功运行 C++ 代码！

1️⃣ Unreal Engine 5 安装

🔹 下载与安装 Unreal Engine 5
步骤：

注册并安装 Epic Games Launcher
- 访问 Unreal Engine 官网下载 Epic Games Launcher。
- 运行安装程序，完成后登录你的 Epic 账户。
安装 Unreal Engine 5
- 在 Epic Games Launcher 左侧导航栏，点击 Unreal Engine → 进入库（Library）。
- 点击 + 号添加 UE5 版本（建议选择最新版，如 5.3+）。
- 选择安装位置并等待下载完成（建议 SSD，至少 50GB 空间）。
勾选 C++ 开发相关组件
- 在安装时，点击选项（Options），勾选：
  ✅ Engine Source Code（引擎源码）
  ✅ Starter Content（示例内容）
  ✅ Editor Symbols for Debugging（调试符号，适用于 C++）

✅ 完成后，启动 UE5 以确保安装成功！ 🎮

2️⃣ 安装 Visual Studio 并配置 C++

UE5 C++ 需要 Visual Studio（VS），推荐使用 VS 2022（兼容性更好）。

🔹 下载与安装 Visual Studio

访问 Visual Studio 官网，下载 Visual Studio 2022 Community 版（免费）。
运行安装程序，在“工作负载”页面，勾选 C++ 游戏开发和 .NET 框架开发。
额外勾选 UE5 需要的组件：
- ✅ MSVC v143（C++ 编译工具）
- ✅ Windows 10/11 SDK
- ✅ C++ CMake 工具
- ✅ C++ 代码分析工具
  安装完成后，重启计算机！ 🔄

3️⃣ 配置 UE5 C++ 开发环境

🔹 关联 Unreal Engine 与 Visual Studio
4. 打开 Unreal Engine 5，点击编辑（Edit）→ 项目设置（Project Settings）。
5. 在 “平台”→“Windows” 下，找到编译器（Compiler）选项，确认已选择 Visual Studio 2022。
6. 在编辑（Edit）→ Editor Preferences（编辑器偏好设置），找到 Source Code（源代码），选择 Visual Studio 2022。
7. 重启 UE5 以应用更改。

4️⃣ 创建你的第一个 UE5 C++ 项目

🔹 新建 UE5 C++ 项目

打开 UE5，点击“创建新项目”。
选择游戏（Game） → 空项目（Blank）。
项目类型选择 C++（不要选蓝图），名称改为 MyFirstCppGame。
选择启用 Starter Content（带基础资源）。
点击创建（Create），等待项目加载。
✅ 你已成功创建 UE5 C++ 项目！🎉

5️⃣ 测试 C++ 代码，确保开发环境正常

🔹 创建并运行一个 C++ 类

在 Unreal Editor 左侧，点击 “C++ 类” → 选择 Actor，命名为 MyFirstActor。
点击创建并打开 Visual Studio，编辑 MyFirstActor.cpp：

#include "MyFirstActor.h"
#include "GameFramework/Actor.h"
#include "Engine/Engine.h"

AMyFirstActor::AMyFirstActor()
{
    PrimaryActorTick.bCanEverTick = true;
}

void AMyFirstActor::BeginPlay()
{
    Super::BeginPlay();
    
    UE_LOG(LogTemp, Warning, TEXT("Hello Unreal Engine C++!"));
}

void AMyFirstActor::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);
}

返回 UE5，点击“编译”按钮（或按 Ctrl + Shift + B 进行编译）。
将 MyFirstActor 拖入场景，点击 “运行（Play）”。
打开 Output Log（输出日志），如果看到 “Hello Unreal Engine C++!”，说明 C++ 代码成功运行！🎉

6️⃣ 遇到问题？常见错误排查

错误	解决方案
无法创建 C++ 项目	确保安装 Visual Studio 2022 + C++ 组件
编译失败（Missing Modules）	右键 .uproject 选择 Generate Visual Studio project files
运行时报错	检查代码拼写，并在 UE5 重新编译 C++
代码修改后无效	在 UE5 点击编译，确保代码已生效