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

为什么对象脚本会越写越大

为什么对象脚本会越写越大

当一个角色脚本同时处理输入、攻击、动画和互动时,新增一个按键判断就可能改变其他动作。本篇从同一帧的动作冲突出发,识别职责膨胀引起的风险,并给出能逐步实施、验证行为不变的拆分办法。

学习目标

  • 识别大对象脚本中相互牵连的职责和共享状态。
  • 用可运行示例解释同帧逻辑冲突与写入顺序依赖。
  • 按状态归属、规则决策和表现职责制定拆分顺序。

膨胀往往从一次顺手添加开始

最初的角色脚本可能只把输入转换成移动。随后为了尽快上线,开发者在同一个更新函数里加攻击、体力消耗、动画切换和交互检测。每个功能单独看都合理,但它们开始读取相同的输入、修改相同的状态,还依赖同一段执行顺序。

危险信号不只是文件超过几百行,而是修改一条攻击规则时必须检查交互、动画甚至死亡处理。一个类拥有的变更理由越多,回归测试范围就越难限定。尤其是逐帧调用的函数,后加入的条件分支可能静默覆盖先前分支的结果。

复现同帧动作冲突

下面是可直接作为 .NET 6 或更高版本控制台程序运行的 C# 示例。它没有使用任何引擎 API,目的是单独暴露逻辑耦合。

csharp
using System;

public sealed class PlayerScript
{
    public int Stamina { get; private set; } = 100;
    public string Animation { get; private set; } = "Idle";
    public bool IsInteracting { get; private set; }

    public void Tick(bool attackPressed, bool interactPressed)
    {
        // 两个分支分别决定行为,却共用同一个动画状态。
        if (attackPressed && Stamina >= 20)
        {
            Stamina -= 20;
            Animation = "Attack";
        }

        if (interactPressed)
        {
            IsInteracting = true;
            Animation = "Interact"; // 后写入的动作覆盖先前选择
        }
    }
}

public static class Program
{
    public static void Main()
    {
        var player = new PlayerScript();
        player.Tick(attackPressed: true, interactPressed: true);
        Console.WriteLine(
            $"Stamina={player.Stamina}, Animation={player.Animation}, Interacting={player.IsInteracting}");
    }
}

预期输出:

text
Stamina=80, Animation=Interact, Interacting=True

攻击已经扣除体力,交互也已开始,但最终动画只有交互。这里没有语法错误;缺少的是“攻击和交互能否同时成立、冲突时谁优先”的统一决定者。若调整两个分支的顺序,最终动画就可能改变,表现逻辑由代码排列而非业务规则决定。

风险沿着共享状态扩散

在真实项目中,问题通常表现为三个连锁影响:输入条件、动作合法性和视觉反馈混写,导致一个按键触发多项动作;死亡或眩晕等状态需要在每个分支重复判断,稍有遗漏就出现非法动作;多个功能直接控制动画或音效,使表现结果取决于最后一个写入者。

把这些函数机械地移到不同文件并不能解决问题。只要多个组件仍然可以任意写入同一个互斥动作状态,耦合就只是换了位置。拆分前必须明确哪个模块负责判定、哪个模块负责执行、哪个模块拥有最终表现状态。

按决策边界拆分而不是按代码长度拆分

可以先让输入层只产生“请求攻击”“请求交互”等意图;由角色动作协调器统一检查体力、当前状态和互斥优先级;再把战斗消耗与交互执行交给各自的功能组件。动画模块消费已经确定的动作结果,而不再自行判断两种输入哪个优先。

单体角色脚本与职责拆分的变化依赖对比

这里的动作协调器不必一开始就做成庞大的全局管理器。只要冲突规则属于单个角色,它就可以由角色内的协调组件负责。真正涉及全场对象的调度或共享资源时,才考虑上移到游戏系统。

用小步迁移检验边界

  1. 列出脚本所处理的输入、修改的字段和向外调用的接口,标出被多个功能写入的状态。
  2. 先锁定原有单一动作行为,再抽出战斗、交互等独立规则;不要同时重构输入和动画。
  3. 给互斥动作设置唯一仲裁入口,让动画只接收已确认的动作结果。
  4. 验证仅攻击、仅交互、两键同帧、体力不足和死亡时的行为,并比较预期与实际结果。

有效拆分的标准不是每个文件都很短,而是新增交互规则时无需编辑战斗计算,调整动画资源时不会改变攻击是否合法,且同帧冲突有可测试、稳定的结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

为什么对象脚本会越写越大

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

登录哪都通