UE5 - 枚举的使用详解

作者：hangge | 2025-07-29 08:40

在大型游戏项目中，状态管理和类型区分往往非常复杂。合适地使用枚举（Enum）可以让蓝图和代码逻辑更加清晰，本文将通过样例演示项目中如何创建并使用枚举。

1，基本介绍

（1）枚举是一种自定义数据类型，其值由一组具有名称的常量组成。枚举通常可以理解为一个规定的集合。

例如，一个枚举“Week”表示一个星期内的七天，那么它的值就会包括 7 个：星期一、星期二、星期三、星期四、星期五、星期六、星期天。
又比如，一个枚举“CharacterMoveState”表示角色的移动状态，那么它可能的值就会包括:站立、趴着、下蹲、移动、奔跑等。

（2）使用枚举的具有如下一些好处：

可读性强：用具名常量取代“魔法数字”，让代码和蓝图逻辑更直观。
易于维护：当需要新增或修改状态/类型时，只需在枚举里增删项，其他逻辑自动跟随。
可视化：在蓝图中，枚举会以下拉列表或开关节点形式展现，便于调试。
类型安全：避免将不相关的整数混用到状态判断中。

2，创建枚举

（1）在内容浏览器（Content Browser）空白位置右击，在弹出的菜单中选择“蓝图” -> “枚举”，然后将创建的枚举文件命名为 E_Fruit。

（2）双击打开刚创建的枚举文件，进入枚举 E_Fruit 的编辑界面，可以单击右上角的“添加枚举器”来创建新的枚举值。这里我们创建三个枚举值，所以可以一次性点击三下，然后逐一输入它们的值。其中，“DisplayName（显示名称)”是枚举的值， “Description（描述)”则是对枚举值的描述。