《Unreal 对 C++ 做了什么》系列增补 01. CDO (Class Default Object)：类默认对象的“母版”哲学-开发者社区

《Unreal 对 C++ 做了什么》系列 (增补篇 01)

增补 01. CDO (Class Default Object)：类默认对象的“母版”哲学 🧬

🚀 导言：每一个 UObject 都有一个“原型”

在标准 C++ 中，类只是一个蓝图，只有通过new实例化后，它才在内存中拥有实体。但在虚幻引擎中，这个规则被打破了：当你定义了一个UCLASS，引擎在启动时就会为你自动创建一个永远存在、有且只有一个的特殊实例——CDO (Class Default Object)。

它是虚幻引擎反射系统和对象模型得以运行的基石。如果说UClass是对象的“灵魂说明书”，那么CDO 就是对象的“出厂样板”。

🔑 1. CDO 的诞生：早于游戏的“预演”

CDO 的生命周期非常特殊，它比任何游戏逻辑都要早。

加载模块：当包含该类的 DLL 被加载到进程中。
执行构造函数：引擎会立即调用该类的构造函数来创建 CDO 实例。

关键点：这就是为什么即使你没点“运行”，甚至没打开地图，你的 C++ 构造函数也会在编辑器启动时执行的原因。

属性灌入：引擎会读取.ini配置文件或 CDO 的元数据，覆盖掉构造函数里的初值。
永驻内存：CDO 存放在一个特殊的包（Package）中，直到引擎关闭才会销毁。

🔑 2. 为什么需要 CDO？（核心逻辑）

● 极致的实例化性能（Memcpy 优化）

在标准 C++ 中创建对象需要运行完整的构造逻辑。而 UE 追求效率：它先打磨好一个 CDO，当你要NewObject时，引擎不再重新运行复杂的计算，而是直接通过内存拷贝 (Memcpy)将 CDO 的数据复制给新对象。这比逐行执行初始化快得多。

● 序列化的“差异化”存储

当你保存一个蓝图或存档时，UE 不会记录对象的所有变量。它会拿你的对象和CDO进行对比：

如果变量值和 CDO 一样，就不保存。
只保存那些被你修改过的“差异项”。
这极大地压缩了磁盘占用，也让“重置为默认值”按钮（Details 面板里的黄色小箭头）有了参考标准。

● 蓝图的父类依据

当你修改蓝图类的默认值时，你本质上是在修改这个蓝图类对应的CDO。所有新生成的实例都会继承这个新的“样板”。

🔑 3. 开发者禁区：构造函数的约束

因为 CDO 是在引擎最底层初始化的，此时游戏环境（World、Renderer、Physics）可能完全不存在。

严禁访问 UWorld：
在构造函数里调用GetWorld()或任何依赖世界的函数（如GetFirstPlayerController）会导致编辑器启动即崩溃。
严禁写业务逻辑：
不要在构造函数里写“伤害计算”、“网络请求”或“UI 刷新”。CDO 也会执行这些逻辑，导致全局状态被意外破坏。
静态变量风险：
如果在构造函数里修改了static变量，由于 CDO 的创建，这个变量在游戏还没开始时就已经被修改过了。

💻 代码实战：如何安全地操作 CDO？

你不需要实例化一个对象，就能通过类信息获取它的默认值。

// 场景：我们需要在 UI 上显示一个武器类的默认伤害，而不需要真的创建一把枪voidUMyUserWidget::DisplayWeaponInfo(TSubclassOf<AWeapon>WeaponClass){if(WeaponClass){// 1. 获取该类的 CDO (样板对象)AWeapon*DefaultWeapon=WeaponClass->GetDefaultObject<AWeapon>();// 2. 读取默认属性（安全且高效，不涉及 SpawnActor）floatBaseDamage=DefaultWeapon->DefaultDamage;UpdateUI(BaseDamage);}}

📊 总结：构造函数 vs CDO vs 实例

阶段	发生时机	核心作用	备注
构造函数	引擎启动/模块加载	构建 CDO 的原始数据	必须是确定性的，严禁逻辑副作用
CDO	随类加载常驻	作为母版提供默认值	每个类唯一，不可在运行时随意修改
Runtime 实例	`NewObject`/`SpawnActor`	真正的游戏对象	从 CDO 拷贝内存而来，执行`BeginPlay`