别名注册与抽象获取¶

当项目有多个具体实现，但调用方只应依赖抽象基类或协议类型时，可以用 alias 把抽象类型映射到具体注册类型。

直接按别名注册¶

class_name JSONConfigProvider
extends GFConfigProvider

func _ready() -> void:
    await Gf.register_utility_as(JSONConfigProvider.new(), GFConfigProvider)

    var configs := Gf.get_utility(GFConfigProvider) as GFConfigProvider

注册后登记别名¶

func _ready() -> void:
    await Gf.register_utility(JSONConfigProvider.new())
    Gf.register_utility_alias(GFConfigProvider, JSONConfigProvider)

当未命中精确类型或 alias 时，框架会尝试寻找唯一的继承匹配。如果多个实例都继承同一个基类，会返回 null 并给出警告。此时应使用显式 alias 消除歧义。

使用边界¶

Model、System 与 Utility 的注册表遵循同一套规则：重复注册会被忽略并提示使用 replace_*()；通过 alias 注销会释放目标实例并清理同目标别名；注册表变化后继承匹配缓存会失效。

显式 alias 会校验 target_cls 必须继承或等于 alias_cls。无关类型会被拒绝，避免 get_utility(AbstractType) 返回无法强转的实例。项目层只需要保持注册键、alias 和实际实例类型一致。