游戏客户端架构 / 系统课时

配置修改后为什么要重新构建对象

配置修改后为什么要重新构建对象

修改配置文件并不等于运行中的对象已经变化。客户端通常会把原始配置转换成带默认值、索引和派生字段的运行时对象,并进一步生成缓存;如果只替换源数据而不重建这些结果,系统就会同时存在新旧两套状态,产生难以复现的逻辑错误。

学习目标

  • 区分原始配置、运行时对象和派生缓存的职责
  • 判断一次配置变更需要重建到哪一层
  • 用版本切换避免旧对象继续持有过期数据

三层数据的职责并不相同

原始配置保存的是可编辑事实,例如伤害、攻速、资源路径。运行时对象会把这些字段转换成程序更方便使用的形式,例如补默认值、解析枚举、建立引用。派生缓存则保存由运行时对象计算出的结果,例如每秒伤害、查找索引或预计算曲线。

原始配置到运行时对象与派生缓存的重建关系

如果只改了源配置,却继续复用旧运行时对象,那么旧对象里的派生字段不会自动重新计算。问题不一定立刻崩溃,而可能表现为“面板数值已更新,但实际攻击间隔还是旧值”。

用一次完整重建消除旧状态

下面的 TypeScript 示例把原始配置转换成不可变运行时对象。每次配置版本变化都重新调用 buildWeapon,因此 attackInterval 和 dps 一定来自同一份源数据。

ts
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);

预期输出:

text
0.5 80
0.4 125

这个结果说明重建后的对象内部是一致的:伤害、攻速、攻击间隔和 DPS 都来自同一版本,而不是在旧对象上零散修改字段。

什么变化必须触发重建

只要某个字段参与对象构造、派生计算、引用解析或索引建立,修改后就应重建受影响对象。典型情况包括数值配置改变后要重算派生属性,资源 ID 改变后要重新解析引用,标签或分组变化后要更新索引。

如果数据仅在每次使用时直接读取,且没有缓存或派生状态,可以不重建。但这种做法会把解析和校验成本推到运行路径中,通常只适合非常小且访问频率低的数据。

热更新时不要原地改半个对象

热更新最容易出现的问题,是先把 damage 改成新值,再异步更新 attackInterval 和索引。其他系统可能刚好在中间状态读取对象,于是得到不一致结果。

更可靠的方式是“构建新版本,再原子切换引用”:先在旁路完成校验和全部派生计算,确认成功后一次性替换当前配置快照。旧对象可以继续完成当前帧或当前战斗,下一次创建时再使用新版本。

重建边界要跟依赖关系一致

重建并不意味着每次都重启整个客户端。关键是找出依赖链:哪张配置变了,哪些运行时对象直接依赖它,哪些缓存又依赖这些对象。只失效受影响的部分,既能保持一致性,也能控制更新成本。

因此,配置修改后的正确动作不是“把内存里的字段改掉”,而是让旧版本失效,用新配置重新生成一套自洽的运行时对象和派生缓存,再安全切换到新版本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置修改后为什么要重新构建对象

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通