游戏客户端架构 / 系统课时
配置修改后为什么要重新构建对象
配置修改后为什么要重新构建对象
修改配置文件并不等于运行中的对象已经变化。客户端通常会把原始配置转换成带默认值、索引和派生字段的运行时对象,并进一步生成缓存;如果只替换源数据而不重建这些结果,系统就会同时存在新旧两套状态,产生难以复现的逻辑错误。
学习目标
- 区分原始配置、运行时对象和派生缓存的职责
- 判断一次配置变更需要重建到哪一层
- 用版本切换避免旧对象继续持有过期数据
三层数据的职责并不相同
原始配置保存的是可编辑事实,例如伤害、攻速、资源路径。运行时对象会把这些字段转换成程序更方便使用的形式,例如补默认值、解析枚举、建立引用。派生缓存则保存由运行时对象计算出的结果,例如每秒伤害、查找索引或预计算曲线。

如果只改了源配置,却继续复用旧运行时对象,那么旧对象里的派生字段不会自动重新计算。问题不一定立刻崩溃,而可能表现为“面板数值已更新,但实际攻击间隔还是旧值”。
用一次完整重建消除旧状态
下面的 TypeScript 示例把原始配置转换成不可变运行时对象。每次配置版本变化都重新调用 buildWeapon,因此 attackInterval 和 dps 一定来自同一份源数据。
type WeaponConfig = {
id: number;
damage: number;
attackPerSecond: number;
};
type WeaponRuntime = Readonly<{
id: number;
damage: number;
attackPerSecond: number;
attackInterval: number;
dps: number;
}>;
function buildWeapon(config: WeaponConfig): WeaponRuntime {
if (config.damage <= 0 || config.attackPerSecond <= 0) {
throw new Error("weapon config must contain positive values");
}
// 派生字段只在构建阶段计算,避免运行中出现半新半旧状态。
return Object.freeze({
...config,
attackInterval: 1 / config.attackPerSecond,
dps: config.damage * config.attackPerSecond
});
}
const v1 = buildWeapon({
id: 101,
damage: 40,
attackPerSecond: 2
});
const v2 = buildWeapon({
id: 101,
damage: 50,
attackPerSecond: 2.5
});
console.log(v1.attackInterval, v1.dps);
console.log(v2.attackInterval, v2.dps);预期输出:
0.5 80
0.4 125这个结果说明重建后的对象内部是一致的:伤害、攻速、攻击间隔和 DPS 都来自同一版本,而不是在旧对象上零散修改字段。
什么变化必须触发重建
只要某个字段参与对象构造、派生计算、引用解析或索引建立,修改后就应重建受影响对象。典型情况包括数值配置改变后要重算派生属性,资源 ID 改变后要重新解析引用,标签或分组变化后要更新索引。
如果数据仅在每次使用时直接读取,且没有缓存或派生状态,可以不重建。但这种做法会把解析和校验成本推到运行路径中,通常只适合非常小且访问频率低的数据。
热更新时不要原地改半个对象
热更新最容易出现的问题,是先把 damage 改成新值,再异步更新 attackInterval 和索引。其他系统可能刚好在中间状态读取对象,于是得到不一致结果。
更可靠的方式是“构建新版本,再原子切换引用”:先在旁路完成校验和全部派生计算,确认成功后一次性替换当前配置快照。旧对象可以继续完成当前帧或当前战斗,下一次创建时再使用新版本。
重建边界要跟依赖关系一致
重建并不意味着每次都重启整个客户端。关键是找出依赖链:哪张配置变了,哪些运行时对象直接依赖它,哪些缓存又依赖这些对象。只失效受影响的部分,既能保持一致性,也能控制更新成本。
因此,配置修改后的正确动作不是“把内存里的字段改掉”,而是让旧版本失效,用新配置重新生成一套自洽的运行时对象和派生缓存,再安全切换到新版本。