Unreal Engine 5 C++ 项目编译失败问题排查与解决

前言

1. 创建工程 使用 Unreal Engine 5 创建 C++ 项目，选择第三人称游戏模板，输入工程名称 MyCppProject。

2. 创建 C++ 类 在内容浏览器中右键选择 "New C++ Class"，父类选择 Actor，类名设为 MyCppActorOne。

3. 添加变量 首次编译正常后，在头文件中添加变量：

int32 myInt;
float myFloat;

4. 编译报错 在 Visual Studio 2022 中再次编译时出现大量错误，主要包括：

• 不允许使用不完整的类型 'TOptional'
• 未定义标识符 'FTextureBuildSettings'
• 未能找到元数据文件
• 命令退出代码为 6

一、问题原因

安装 Visual Studio 2022 时可能未选择 UE5 相关组件，或 UE5.5.4 更新了组件导致 VS2022 兼容性不足。此外，清理缓存和重新生成工程也是常见解决手段。

二、安装 Visual Studio 2022 相关 UE5 组件

1. 打开 Windows 系统下的 Visual Studio Installer。
2. 找到已安装的 Visual Studio 2022 版本。
3. 点击'修改'，确保勾选了与 Unreal Engine 相关的 C++ 开发组件（如 Windows 10 SDK、C++ 工具等）。
4. 安装完成后重启 Visual Studio 2022。

三、注意的问题

在 Visual Studio IDE 中添加变量和函数时，即使代码逻辑正确，若环境配置不全仍会报错。例如以下代码结构本身无误，但缺少组件会导致编译失败：

头文件 (MyCppActorOne.h)

#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "MyCppActorOne.generated.h"

UCLASS()
class  AMyCppActorOne :  AActor
{
    ()
:
    ();
:
    ;
:
    ;
    
    (BlueprintReadOnly)
    int32 MyInt;
    
    (BlueprintReadWrite)
     MyFloat;

    (BlueprintCallable, Category = )
    ;
};