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

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

1️⃣ Unreal Engine 5 安装

下载与安装 Unreal Engine 5
步骤：

1. 注册并安装 Epic Games Launcher
   • 访问 Unreal Engine 官网 下载 Epic Games Launcher。
   • 运行安装程序，完成后 登录你的 Epic 账户。
2. 安装 Unreal Engine 5
   • 在 Epic Games Launcher 左侧导航栏，点击 Unreal Engine → 进入 库（Library）。
   • 点击 + 号 添加 UE5 版本（建议选择最新版，如 5.3+）。
   • 选择 安装位置 并等待下载完成（建议 SSD，至少 50GB 空间）。
3. 勾选 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

1. 访问 Visual Studio 官网，下载 Visual Studio 2022 Community 版（免费）。
2. 运行安装程序，在“工作负载”页面，勾选 C++ 游戏开发 和 .NET 框架开发。
3. 额外勾选 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++ 项目

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

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

创建并运行一个 C++ 类

1. 在 Unreal Editor 左侧，点击 “C++ 类” → 选择 Actor，命名为 MyFirstActor。
2. 点击创建并打开 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);
}

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

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

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

总结：今天你学到了什么？

✅ 安装 Unreal Engine 5 并配置 C++ 开发环境
✅ 安装 Visual Studio 2022 并关联 UE5
✅ 创建 UE5 C++ 项目，编写 & 运行第一个 C++ 代码
✅ 解决常见开发环境问题

恭喜！你已经成功完成 UE5 C++ 开发环境搭建，明天我们将进入 C++ 代码结构解析！

记得收藏本专栏，每天进步一点，最终掌握 UE5 C++ 开发！