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

先画依赖图再开始重构

先画依赖图再开始重构

角色系统越来越大时,直接拆分类或搬移方法往往只会把耦合转移到新组件。本节先把现有玩家对象、战斗、生命值和表现系统的关系画成依赖图,再找出循环调用与高扇出节点,确定一处可以小步验证的重构切口。

学习目标

  • 从现有代码提取对象、组件、服务及其真实依赖。
  • 区分持有关系、同步调用与事件通知,识别循环和热点。
  • 按行为风险安排重构顺序,并用依赖图和回归测试验收。

统一节点和箭头的含义

先固定图的粒度:Player 是对象宿主,Movement、Health、Attack 是组件,HUD 是界面模块,Audio、Quest 是跨对象服务。不要把函数调用、运行时实例与配置资产混成同一类节点,否则一张图无法说明哪个边界出了问题。

对每条关系记录“谁依赖谁”和“为什么依赖”:持有或装配、读取状态、同步调用、发布或订阅事件。依赖箭头统一从使用者指向被使用者,例如 HUD → Health 表示 HUD 主动查询生命值;事件的通知方向则单独使用虚线,不与代码依赖混淆。

开始时只记录现状,不提前把理想中的事件总线和接口画成既有系统。静态引用可以从构造参数、字段、导入和直接方法调用查起;运行时通过服务定位器获得的依赖,也应补到图上。

画出角色当前的职责边界

假设现状是:Player 持有 Movement 和 Health;Attack 读取 Health;Health 直接调用 HUD、Audio、Quest;但 HUD 又反向读取 Health。这张图马上暴露两类风险:Health ↔ HUD 的代码环,以及 Health 对三个外部模块的扇出。

角色系统现状依赖图与高风险关系标注

读图时先问三件事:哪些连线跨过了对象与系统边界,哪两条边闭合成环,哪个节点改动后会牵动最多调用方。高扇出只是候选风险,不自动等于性能瓶颈;真正的热点仍需结合变更记录、调用频率和运行时分析判断。

用脚本定位最先检查的依赖

下例把人工整理的关系保存成列表,用深度优先搜索找出一条循环依赖,并统计每个节点对外的直接代码依赖数。保存为 JavaScript 文件后用 Node.js 运行;它分析的是输入清单,不会自动扫描项目源码。

js
const links = [
  ["Player", "Movement", "owns"],
  ["Player", "Health", "owns"],
  ["Attack", "Health", "reads"],
  ["Health", "HUD", "calls"],
  ["HUD", "Health", "reads"],
  ["Health", "Audio", "calls"],
  ["Health", "Quest", "calls"]
];

const graph = new Map();
// 持有关系保留在原始清单,但不参与这次代码依赖环检查
for (const [from, to, kind] of links) {
  if (kind === "owns") continue;
  if (!graph.has(from)) graph.set(from, []);
  if (!graph.has(to)) graph.set(to, []);
  graph.get(from).push(to);
}

const visiting = new Set();
const visited = new Set();
const path = [];

function findCycle(node) {
  visiting.add(node);
  path.push(node);
  for (const next of graph.get(node)) {
    if (visiting.has(next)) {
      return [...path.slice(path.indexOf(next)), next];
    }
    if (!visited.has(next)) {
      const found = findCycle(next);
      if (found) return found;
    }
  }
  path.pop();
  visiting.delete(node);
  visited.add(node);
  return null;
}

let cycle = null;
for (const node of graph.keys()) {
  if (!visited.has(node)) cycle = findCycle(node);
  if (cycle) break;
}

// 扇出仅是初筛指标,不代表实际运行开销
const most = [...graph].map(([node, targets]) => [node, targets.length])
  .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))[0];

console.log("循环依赖:", cycle ? cycle.join(" -> ") : "无");
console.log("直接依赖最多:", `${most[0]} (${most[1]})`);

预期输出:

text
循环依赖: Health -> HUD -> Health
直接依赖最多: Health (3)

脚本报告的是第一条找到的环,而不是所有环;节点数量增大时可换用强连通分量算法。这里没有把 owns 当作同步调用,因为对象宿主的持有关系与两个组件互相依赖代码并非同一问题。真实项目还需核对接口实现、动态查找和隐藏的单例调用。

把依赖图转成可验收的重构顺序

先为当前行为建立回归基线:受伤后生命值正确变化,HUD 更新一次,音效与任务逻辑各触发预期次数,销毁对象后不会再更新旧界面。这样重构后才能区分架构改善和行为意外改变。

第一刀可选择删除 Health → HUD 的直接调用,让 Health 发布生命值变化事实,由 HUD 订阅并在自身销毁时解绑;Health → Audio 和 Health → Quest 也可逐步改为同类通知。HUD 仍可通过只读接口获取首次显示所需快照,但不应把更新决策再推回生命值组件。Player 对子组件的正常持有关系暂时保留,无须为了消除环而拆除所有引用。

每完成一个切口,就重新绘制现状图、更新关系清单并运行检测,再比对回归测试和关键帧性能。验收标准不是“箭头变少”,而是没有不必要的双向代码依赖、组件可以独立替换、行为未回退,新增关系仍有明确的拥有者。

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

目录与阅读设置

阅读设置

17

记录一个想法

先画依赖图再开始重构

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

登录哪都通