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

第 2 天：创建你的第一个 UE5 C++ 项目！

article 2025/2/4 21:38:02

🎯 目标：

掌握 UE5 C++ 项目的创建流程，了解代码结构，并成功运行第一个 C++ 类！

1️⃣ 创建 UE5 C++ 项目

在 UE5 中，C++ 项目可以与蓝图（Blueprint）结合使用，让游戏逻辑更灵活。今天我们将创建一个全新的 C++ 项目，并探索其基本结构。

🔹 新建 C++ 项目步骤

打开 Unreal Engine 5（启动 Epic Games Launcher → 选择 UE5）。
点击“创建新项目”，在项目类型中选择游戏（Game）。
选择“空项目（Blank）”，确保是 C++ 项目（不要选蓝图）。
启用 Starter Content（包含基础素材），方便后续使用。
设定项目名称（如 MyFirstCppGame），选择保存路径，点击创建（Create）。
等待 UE5 加载，默认会自动打开 Visual Studio，准备进行 C++ 开发！ 🎮

✅ 成功创建 C++ 项目后，你的开发环境已经准备就绪！ 🚀

2️⃣ UE5 C++ 项目结构解析

创建项目后，我们的工程目录会包含多个关键文件夹：

文件夹	作用
Source/	存放所有 C++ 代码
Source/MyFirstCppGame/	游戏的主 C++ 代码文件夹
Source/MyFirstCppGame/MyFirstCppGame.Build.cs	项目编译设置
Config/	配置文件（游戏启动参数等）
Content/	资源文件（材质、模型、声音等）
Binaries/	编译后的二进制文件
Intermediate/	临时文件（无需手动修改）
Saved/	项目保存的临时数据

其中，Source 文件夹最重要，是我们编写 C++ 代码的地方。

3️⃣ 创建并运行你的第一个 C++ 类

🔹 创建 C++ 类

在 UE5 中，点击“工具” → “新建 C++ 类”。
选择 Actor 作为基类（它是 UE5 世界中的基本对象）。
命名为 MyFirstActor，点击创建并添加到项目。
等待 UE5 自动生成 C++ 代码并打开 Visual Studio。

4️⃣ 修改 C++ 代码

打开 MyFirstActor.cpp 并编辑 BeginPlay() 方法，让它在游戏启动时打印一条消息：

📌 MyFirstActor.h（头文件）

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "MyFirstActor.generated.h"

UCLASS()
class MYFIRSTCPPGAME_API AMyFirstActor : public AActor
{
    GENERATED_BODY()

public:	
    AMyFirstActor();

protected:
    virtual void BeginPlay() override;
};

📌 MyFirstActor.cpp（实现文件）

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

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

void AMyFirstActor::BeginPlay()
{
    Super::BeginPlay();

    // 在控制台和输出日志中打印 "Hello Unreal Engine C++!"
    UE_LOG(LogTemp, Warning, TEXT("Hello Unreal Engine C++!"));
}

5️⃣ 编译 & 运行

🔹 编译 C++ 代码

返回 UE5，点击右下角的编译按钮
等待编译完成，如果没有报错，则说明 C++ 代码已正确编译！

🔹 在场景中使用 C++ Actor
4. 回到 UE5 编辑器，打开 “世界大纲（World Outliner）” 窗口。
5. 找到 MyFirstActor 并拖入场景。
6. 点击 “播放（Play）”，然后打开左下角的输出日志（Output Log），可以看到：

LogTemp: Warning: Hello Unreal Engine C++!

✅ 你成功创建并运行了你的第一个 UE5 C++ 类！🎉

6️⃣ 常见问题 & 解决方案

问题	解决方案
项目创建失败	确保 Visual Studio 2022 已安装，并包含 C++ 开发组件
编译失败	在 UE5 中点击“工具”→“刷新 Visual Studio 项目”
C++ 代码修改后无效	重新编译（Ctrl + Shift + B），并重启 UE5
UE_LOG 没有输出	确保打开输出日志窗口（Window → Developer Tools → Output Log）