UE5新手必看：如何用C++给Actor添加StaticMesh和PointLight组件（附动态变色技巧）-CSDN博客

UE5 C++实战：从零构建一个会呼吸的动态光源Actor

刚接触Unreal Engine 5的C++开发，很多人会被蓝图和C++之间的选择困扰。蓝图直观，但项目规模一大，性能和维护就成了问题；C++强大，可那一行行代码和复杂的类体系，又让新手望而却步。今天，我们不谈空泛的理论，直接上手一个既经典又实用的案例：用C++创建一个自带静态网格体和点光源的Actor，并让它的灯光像呼吸一样律动变色。

这个案例麻雀虽小，五脏俱全。它涵盖了C++ Actor类的创建、组件的声明与初始化、资源加载、组件附着关系，以及如何在游戏运行时进行动态更新。无论你是想为场景放置一个自定义的环境光源，还是为某个交互物品添加动态的视觉反馈，这套流程都是坚实的基础。我们假设你已经配置好了UE5的C++开发环境（Visual Studio或Rider），并且创建了一个启用了C++的空白项目。接下来，就让我们进入代码的世界。

1. 蓝图与C++的抉择：为何要从C++开始？

在UE5的世界里，蓝图视觉化脚本无疑是快速原型设计的利器。拖拽节点、连接引脚，功能即刻可见。但对于核心的游戏机制、高频调用的逻辑或是需要团队协作的大型项目，C++的优势就凸显出来了。

性能与控制力：C++编译后是原生机器码，执行效率远高于需要虚拟机解释的蓝图。对于每帧都在运行的逻辑（如我们即将实现的动态变色），C++是更优的选择。
代码维护与重构：当你的游戏系统变得复杂时，蓝图图表可能会变成一团难以理清的“面条”。C++代码则可以通过清晰的类结构、函数和注释来组织，更易于版本管理（如Git）和团队协作。
功能深度：引擎的许多底层功能和高级API只对C++开放。虽然蓝图暴露了海量功能，但总有你需要“钻得更深”的时候。

提示：对于新手，一个高效的策略是“用C++搭建骨架，用蓝图填充血肉”。即用C++实现核心的数据结构和算法，再在蓝图中进行灵活的配置和组合。

所以，学习用C++操作Actor和组件，不是抛弃蓝图，而是为了在两者之间做出更明智的选择，让你的工具链更加完整。

2. 创建自定义Actor类与组件声明

一切始于一个自定义的C++类。我们不会使用编辑器中的“Actor”蓝图，而是要从代码层面定义一个新的Actor类型。

2.1 创建C++类

在Unreal编辑器的内容浏览器中，右键点击任意位置，选择 “新建C++类”。在类选择对话框中，确保父类为 “Actor”。我们将这个新类命名为 BP_DynamicLightActor（前缀BP_仅用于示例，表示这是C++基类，后续可由蓝图继承）。点击创建后，编辑器会生成头文件（.h）和源文件（.cpp），并自动打开你的IDE。

2.2 在头文件中声明组件

打开生成的头文件 BP_DynamicLightActor.h。我们的目标是让这个Actor拥有一个可见的形态（静态网格体）和一个发光的核心（点光源）。因此，我们需要声明两个组件指针，并标记为UPROPERTY，这样它们才能被Unreal的属性系统识别和管理，并在编辑器中可见。

// BP_DynamicLightActor.h
#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "Components/StaticMeshComponent.h" // 引入静态网格体组件头文件
#include "Components/PointLightComponent.h" // 引入点光源组件头文件
#include "BP_DynamicLightActor.generated.h" // 必须的生成宏

UCLASS()
class YOURPROJECT_API ABP_DynamicLightActor : public AActor
{
    GENERATED_BODY()

public:
    // 构造函数
    ABP_DynamicLightActor();

protected:
    // 游戏开始或Actor生成时调用
    virtual void BeginPlay() override;

public:
    // 每帧调用
    virtual void Tick(float DeltaTime) override;

private:
    // 声明静态网格体组件
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components", meta = (AllowPrivateAccess = "true"))
    UStaticMeshC