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

制定组件架构演进规则

制定组件架构演进规则

组件化重构完成后,新的需求仍可能把直接调用、全局查询和共享可变状态重新带回来。本课将组件边界、依赖方向、消息契约、配置归属和性能观测写成可审查的规则,并用一段轻量检查脚本演示怎样在合并代码前发现回退。

学习目标

  • 为组件职责、依赖方向、通信方式和配置状态划出可执行边界。
  • 使用结构清单检查违规依赖、字段混用和逐帧查询。
  • 建立包含契约测试、性能基线和例外审批的变更流程。

先固定不能随需求漂移的边界

规则要能回答“谁负责、谁可以依赖谁、违反后如何发现”,不能只写“保持低耦合”。以下是一组可按项目调整的基础约束。

范围 约束 主要检查方式
组件职责 一个组件只拥有一类能力及其运行状态;避免巨型组件与只转发调用的伪组件 设计评审、变更影响检查
依赖方向 基础规则层不依赖玩法或表现层;表现层不能直接引用玩法实现;禁止循环依赖 依赖清单与静态检查
通信契约 一对一同步操作优先显式能力接口;一对多状态通知用具名事件,并规定载荷与解绑时机 API 评审、事件契约测试
数据归属 只读模板保存默认配置;实例持有血量、冷却等可变状态;临时缓存不得写回共享模板 配置审查、双实例测试
热路径 每帧逻辑不做反复层级查找;组件数不是性能结论,须看真实耗时和分配 性能采样与对比

例如 Attack 依赖稳定的 DamageRules 能力,而 Health 发布 health.changed 供 HUD 订阅。HUD 不应为了刷新文本去穿透访问 Health 的内部字段。事件名、载荷字段、是否允许重入与谁负责解绑,都应写在同一份契约中。

组件依赖方向、配置归属与变更质量门禁

用结构清单阻止常见回退

不必等待一个完整的架构分析平台才能启动约束。下面的 Python 3 脚本将组件清单当作示例输入,检查依赖目标与层级、配置和实例字段交叉、逐帧查询以及事件发布者缺失。它不是 Unity、Unreal 或 Godot 的内置工具,实际项目需要从代码或资产导出这份清单,避免手写清单与实现脱节。

python
from copy import deepcopy

ALLOWED = {
    "foundation": set(),
    "gameplay": {"foundation", "gameplay"},
    "presentation": {"foundation", "presentation"},
}

def spec(layer, deps=(), config=(), runtime=(), queries=0,
         emits=(), listens=()):
    return {
        "layer": layer, "deps": list(deps),
        "config": set(config), "runtime": set(runtime),
        "queries": queries, "emits": list(emits),
        "listens": list(listens),
    }

components = {
    "DamageRules": spec("foundation", config=("baseDamage",)),
    "Attack": spec("gameplay", deps=("DamageRules",),
                   runtime=("cooldownMs",)),
    "Health": spec("gameplay", config=("maxHp",),
                   runtime=("currentHp",), emits=("health.changed",)),
    "Hud": spec("presentation", runtime=("visibleHp",),
                listens=("health.changed",)),
}

def has_cycle(items):
    state = {}

    def visit(name):
        if state.get(name) == 1:
            return True
        if state.get(name) == 2:
            return False
        state[name] = 1
        for dep in items[name]["deps"]:
            if dep in items and visit(dep):
                return True
        state[name] = 2
        return False

    return any(visit(name) for name in items)

def check(items):
    errors = []
    topics = {topic for item in items.values() for topic in item["emits"]}
    for name, item in items.items():
        for dep in item["deps"]:
            if dep not in items:
                errors.append(f"{name}:未知依赖 {dep}")
            elif items[dep]["layer"] not in ALLOWED[item["layer"]]:
                errors.append(f"{name}:禁止依赖 {dep}")
        if item["config"] & item["runtime"]:
            errors.append(f"{name}:配置与状态字段重叠")
        if item["queries"] > 0:
            errors.append(f"{name}:禁止逐帧查询组件")
        for topic in item["listens"]:
            if topic not in topics:
                errors.append(f"{name}:缺少事件发布者 {topic}")
    if has_cycle(items):
        errors.append("存在循环依赖")
    return errors

assert not check(components)
print("基线规则:通过")

broken = deepcopy(components)
broken["Hud"]["deps"].append("Health")
broken["Hud"]["queries"] = 1
print("违规变更:" + ";".join(check(broken)))

预期输出:

text
基线规则:通过
违规变更:Hud:禁止依赖 Health;Hud:禁止逐帧查询组件

脚本把违规变更变成可复现的失败信号,但只检查清单声明,不能证明组件职责合理、配置资产实际只读,或事件已经正确解绑。后者仍依赖代码审查、双实例隔离测试和生命周期回归测试。

为性能建立可比较的基线

性能规则不能简化为“组件超过某个数量就不准合并”。应在相同场景、平台、设备、采样时长和 NPC 数量下比较改动前后,并记录至少以下指标:

  • 主线程帧耗时及其高分位值,区分总帧耗时与组件更新耗时。
  • 高频组件的调用次数、层级查找次数,以及每帧分配量。
  • 事件发布频率、实际回调次数、启停后订阅者数量。
  • 生成、停用、销毁和对象池复用时的峰值耗时与残留对象数量。

阈值由项目基线和目标设备预算决定,而非照搬一个通用常数。例如要求“每帧重复层级查询为零”是适合静态门禁的工程约束;“每帧必须低于多少毫秒”则要基于目标帧率、已有负载和采样结果确定。记录测试场景与采样方法,否则两次数据不能直接比较。

把规则变成可执行的变更流程

一次组件变更应留下足够的审查证据,而不是只提交通过编译的代码。

  1. 提交变更说明:列出组件职责、拥有的运行状态、公开接口、依赖对象以及新增或调整的事件。
  2. 执行自动门禁:从真实工程生成依赖清单,运行规则检查;执行初始化、启停、销毁、重复订阅和配置实例隔离测试。
  3. 比较性能基线:对受影响的热路径附上同条件下的前后采样。若没有影响,也要明确不涉及逐帧或批量实例逻辑。
  4. 处理破例:对确需跨层依赖或缓存例外的改动,写明负责人、原因、影响范围、替代方案和复查条件,不允许无记录地跳过。
  5. 发布与回滚:涉及事件载荷或配置格式变更时,先安排消费者兼容和迁移测试,再删除旧契约;保留可回滚方案。

最终规则应跟代码一起版本管理,并在每次异常、性能回退或需求扩展后修订。能够被检查、能指明责任人且有例外处理办法的约束,才会真正约束后续开发。

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

目录与阅读设置

阅读设置

17

记录一个想法

制定组件架构演进规则

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

登录哪都通