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

直接引用什么时候最合适

直接引用什么时候最合适

组件间通信不一定需要事件总线、服务定位器或复杂接口。对于同一游戏对象上关系固定、生命周期明确的组件,直接引用往往最简单可靠。本课比较直接绑定、运行时查询和依赖注入的使用边界,并用一个生命值与 HUD 协作示例说明如何避免过度抽象。

学习目标

  • 判断组件间什么时候适合使用稳定的直接引用。
  • 区分直接绑定、组件查询和依赖注入的适用条件。
  • 实现具有明确依赖关系的组件协作,并识别引用失效风险。

直接引用适合稳定的一对一关系

直接引用是指组件保存另一个组件的明确引用,并通过其公开成员进行调用或读取。它的核心优势是依赖关系直观,调用过程短,错误容易定位。

例如,一个角色的 HealthHud 需要读取同一个角色的 HealthComponent。只要角色存在,生命值组件就必须存在,而且两者通常由同一个宿主管理。这种固定关系没有必要先经过全局事件总线或运行时服务定位器。

判断是否适合直接引用,可以检查三个条件:

  1. 目标是否确定:依赖对象在装配阶段就能明确,而不是每次调用都需要重新寻找。
  2. 关系是否稳定:依赖对象不会频繁更换,其生命周期受明确的宿主管理。
  3. 职责是否清晰:调用方只使用目标公开的必要能力,不需要穿透目标访问大量内部实现。

满足这些条件时,直接引用能够减少间接层级,也不会因为少了一层抽象而天然变得难以维护。

但直接引用不等于任意访问内部字段。HealthHud 可以通过公开属性读取生命值,不应该直接修改生命值组件的内部状态,也不应该顺着一个对象引用继续访问无关组件。

直接绑定、查询和注入有什么区别

实际项目通常使用三种方式取得组件依赖。它们解决的问题不同,并不需要互相排斥。

方式 典型场景 主要注意点
直接绑定引用 固定宿主上的必要组件、稳定的一对一关系 初始化时确认非空,避免引用失效
查询组件 组件可能存在也可能缺失,或由运行时装配决定 检查查询结果,避免无意义地反复搜索
依赖注入 需要替换实现、复用模块或进行隔离测试 由装配者提供依赖,避免把构造关系隐藏起来

这里还需要区分两个问题:如何取得依赖与取得依赖后如何通信。

直接引用描述的是组件保存并使用目标引用;查询和注入主要描述引用如何被取得。因此,组件完全可以通过构造函数注入依赖,然后把它保存为一个直接引用。两种设计并不冲突。

直接绑定、运行时查询和依赖注入的组件关系对比

对于固定对象关系,通常在创建或初始化阶段完成一次依赖绑定即可。对于可选组件,可以在初始化阶段查询并缓存结果;如果运行时允许组件被添加、移除或替换,则需要明确缓存失效和重新绑定机制。

依赖注入更适合能力稳定但实现可能变化的协作。例如战斗 UI 只需要读取生命值,可以依赖只读接口,由装配者决定提供真实组件还是测试替身。不过,只有一种实现、也没有替换需求时,不必为了形式上的解耦强制创建大量接口。

实现固定的生命值与 HUD 引用

下面以独立 C# 程序模拟同一个角色内的组件协作。HealthComponent 管理生命值,HealthHud 只负责读取并格式化显示内容。

关键设计是由装配代码创建两个组件,并在创建 HUD 时传入确定的生命值组件。HUD 不负责到全局环境中寻找依赖。

将以下代码放入 .NET 6 或更新版本控制台项目的 Program.cs,即可运行。

csharp
using System;

var health = new HealthComponent(100);

// 由装配阶段绑定同一个角色上的固定依赖
var hud = new HealthHud(health);

health.TakeDamage(30);
Console.WriteLine(hud.ReadText());

sealed class HealthComponent
{
    public int MaxHp { get; }
    public int Hp { get; private set; }

    public HealthComponent(int maxHp)
    {
        if (maxHp <= 0)
            throw new ArgumentOutOfRangeException(nameof(maxHp));

        MaxHp = maxHp;
        Hp = maxHp;
    }

    public void TakeDamage(int amount)
    {
        if (amount < 0)
            throw new ArgumentOutOfRangeException(nameof(amount));

        // 生命值由自身维护,防止伤害计算越过下界
        Hp = Math.Max(0, Hp - amount);
    }
}

sealed class HealthHud
{
    private readonly HealthComponent _health;

    public HealthHud(HealthComponent health)
    {
        // 必要依赖应在创建时检查,避免延迟暴露错误
        _health = health ??
            throw new ArgumentNullException(nameof(health));
    }

    public string ReadText()
    {
        return $"HP {_health.Hp}/{_health.MaxHp}";
    }
}

预期输出:

text
HP 70/100

HealthComponent 从 100 点生命值扣除 30 点后,HUD 直接读取同一实例的最新数据,输出 HP 70/100。

这个示例同时体现了构造函数注入和直接引用:依赖通过构造函数传入,随后由只读字段 _health 保存。HealthHud 不必知道 HealthComponent 如何被创建,也不需要额外的全局查找步骤。

示例使用主动调用 ReadText 的方式验证读取结果。在真实游戏 UI 中,可以由界面刷新调度器调用读取方法,也可以由生命值变化事件触发刷新。这是刷新时机的选择,不要求放弃已经确定的组件引用。

什么时候应该改用查询或接口

直接引用最容易出问题的地方,不是调用本身,而是依赖关系在运行时发生了变化。

例如,一个技能组件可能被装备系统动态装上或卸下。角色初始化时找不到这个技能组件并不一定是错误,使用可选查询更合理。查询失败时应明确禁用相关能力,而不是立即访问空引用。

再比如,战斗结算器可能面对玩家、敌人、可破坏物等不同目标。如果调用方必须判断每一种具体组件类型,再分别调用不同方法,那么它已经依赖了过多实现细节。

此时可以提取稳定的能力接口,例如 IDamageReceiver,由不同对象提供自己的伤害处理实现。战斗结算器只关心接口契约,不关心目标内部如何管理生命值、护甲或破坏状态。

还需要警惕以下几类设计:

  • 每帧重复查询始终不变的必需组件,增加开销并隐藏固定依赖。
  • 通过一个组件引用继续穿透访问多个无关组件,让局部调用演变成跨对象控制。
  • 为每个简单方法建立接口、事件、消息和中介层,使调用链难以追踪。
  • 长期缓存可能被销毁或替换的组件引用,却没有有效性检查和重新绑定策略。

检查依赖关系是否真正稳定

在使用直接引用前,应当从装配、运行和销毁三个阶段验证。

  1. 装配阶段:必要组件是否一定存在?缺失时能否尽早报告配置错误?
  2. 运行阶段:引用目标是否可能被替换?如果会替换,谁负责更新引用?
  3. 销毁阶段:调用方是否可能比依赖对象存活更久?如果会,谁负责停止调用并解除引用?

对于 Unity 的固定组件装配,可以通过序列化引用或初始化时的 GetComponent 获取必要依赖;对于 Unreal Engine,可以使用明确的组件成员与初始化绑定;Godot 中也可以使用节点引用完成稳定装配。具体获取方法由引擎决定,但设计原则相同。

只有当组件关系确实可能变化,或者必须隔离具体实现时,增加查询机制、接口和注入层才具有明确收益。

组件解耦的目标不是消除所有直接调用,而是避免不稳定、越界和无法管理的依赖。对于生命周期一致、目标确定、职责明确的组件,直接引用往往就是最适合的工程选择。

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

目录与阅读设置

阅读设置

17

记录一个想法

直接引用什么时候最合适

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

登录哪都通