游戏客户端架构 / 系统课时
为什么对象脚本会越写越大
为什么对象脚本会越写越大
当一个角色脚本同时处理输入、攻击、动画和互动时,新增一个按键判断就可能改变其他动作。本篇从同一帧的动作冲突出发,识别职责膨胀引起的风险,并给出能逐步实施、验证行为不变的拆分办法。
学习目标
- 识别大对象脚本中相互牵连的职责和共享状态。
- 用可运行示例解释同帧逻辑冲突与写入顺序依赖。
- 按状态归属、规则决策和表现职责制定拆分顺序。
膨胀往往从一次顺手添加开始
最初的角色脚本可能只把输入转换成移动。随后为了尽快上线,开发者在同一个更新函数里加攻击、体力消耗、动画切换和交互检测。每个功能单独看都合理,但它们开始读取相同的输入、修改相同的状态,还依赖同一段执行顺序。
危险信号不只是文件超过几百行,而是修改一条攻击规则时必须检查交互、动画甚至死亡处理。一个类拥有的变更理由越多,回归测试范围就越难限定。尤其是逐帧调用的函数,后加入的条件分支可能静默覆盖先前分支的结果。
复现同帧动作冲突
下面是可直接作为 .NET 6 或更高版本控制台程序运行的 C# 示例。它没有使用任何引擎 API,目的是单独暴露逻辑耦合。
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}");
}
}预期输出:
Stamina=80, Animation=Interact, Interacting=True攻击已经扣除体力,交互也已开始,但最终动画只有交互。这里没有语法错误;缺少的是“攻击和交互能否同时成立、冲突时谁优先”的统一决定者。若调整两个分支的顺序,最终动画就可能改变,表现逻辑由代码排列而非业务规则决定。
风险沿着共享状态扩散
在真实项目中,问题通常表现为三个连锁影响:输入条件、动作合法性和视觉反馈混写,导致一个按键触发多项动作;死亡或眩晕等状态需要在每个分支重复判断,稍有遗漏就出现非法动作;多个功能直接控制动画或音效,使表现结果取决于最后一个写入者。
把这些函数机械地移到不同文件并不能解决问题。只要多个组件仍然可以任意写入同一个互斥动作状态,耦合就只是换了位置。拆分前必须明确哪个模块负责判定、哪个模块负责执行、哪个模块拥有最终表现状态。
按决策边界拆分而不是按代码长度拆分
可以先让输入层只产生“请求攻击”“请求交互”等意图;由角色动作协调器统一检查体力、当前状态和互斥优先级;再把战斗消耗与交互执行交给各自的功能组件。动画模块消费已经确定的动作结果,而不再自行判断两种输入哪个优先。

这里的动作协调器不必一开始就做成庞大的全局管理器。只要冲突规则属于单个角色,它就可以由角色内的协调组件负责。真正涉及全场对象的调度或共享资源时,才考虑上移到游戏系统。
用小步迁移检验边界
- 列出脚本所处理的输入、修改的字段和向外调用的接口,标出被多个功能写入的状态。
- 先锁定原有单一动作行为,再抽出战斗、交互等独立规则;不要同时重构输入和动画。
- 给互斥动作设置唯一仲裁入口,让动画只接收已确认的动作结果。
- 验证仅攻击、仅交互、两键同帧、体力不足和死亡时的行为,并比较预期与实际结果。
有效拆分的标准不是每个文件都很短,而是新增交互规则时无需编辑战斗计算,调整动画资源时不会改变攻击是否合法,且同帧冲突有可测试、稳定的结果。