游戏引擎 / 系统课时

用工具函数收拢重复逻辑

用工具函数收拢重复逻辑

多个组件各自限制血量范围,遇到非法边界时却表现不同。本节提取一个参数明确、没有场景依赖的范围限制函数,再验证普通值、越界值与非法范围,让复用来自稳定规则,而不是把不相关的小代码都塞进工具文件。

学习目标

  • 提取只依赖参数的纯函数。
  • 明确函数输入范围与异常策略。
  • 避免工具函数隐藏全局状态或引擎副作用。

先确认重复的是同一条规则

两段相似代码不一定具有相同需求:血量限制、音量限制和坐标限制可能对非法输入有不同策略。先找出共同规则,再决定是否复用。这里统一接受有限数值与合法最小最大值,非法输入抛错,正常输入限制在闭区间内。

纯函数的结果只依赖参数,不读当前场景、不写共享变量,也不修改传入对象。这样调用者看签名就知道依赖,独立程序也能验证边界。如果工具函数内部偷偷读取全局难度或节点位置,即使函数短,也会把隐藏状态带到所有调用处。

完整实现并验证边界

文件:main.ts,完整纯 TypeScript 主例程。

ts
export {};
function clamp(value: number, min: number, max: number): number {
    // NaN 与倒置范围不能被当成普通越界值处理。
    if (![value, min, max].every(Number.isFinite) || min > max) {
        throw new Error('invalid range');
    }
    return Math.min(max, Math.max(min, value));
}
console.log([clamp(-3, 0, 100), clamp(20, 0, 100), clamp(120, 0, 100)].join('|'));
try {
    // 非法配置要显式失败,避免静默交换边界掩盖问题。
    clamp(20, 100, 0);
} catch (error: unknown) {
    console.log(error instanceof Error ? error.message : 'unknown');
}

预期输出:

text
0|20|100
invalid range

三个普通输入分别验证低于范围、范围内与高于范围。倒置范围主动报错,使配置错误能够在调用边界被发现。如果业务选择容错并交换上下限,应把这个策略写进函数名称或说明,而不是让调用方猜测。

不把表现逻辑混进计算

clamp 返回数值,不负责更新 Label 或播放受伤动画。组件先用它计算新血量,再决定显示和反馈。范围限制也不会验证“角色是否可以被伤害”,那属于状态规则。函数职责越明确,越容易判断何时可以复用,何时必须保持独立。

格式化函数同样应接受明确参数,例如当前分数与语言选项,而不是直接读取全局 UI。若不同界面需要不同格式,应增加有意义的参数或分开函数,不要通过不断添加可选布尔值制造难以理解的调用方式。

为复用保留稳定位置

将函数移到一个按职责命名的模块,如 numeric.ts,再用命名导出供组件引用。不要让工具模块反过来导入业务组件,否则最底层规则依赖了最上层场景。也不需要为三行计算建立类、单例和生命周期,普通函数已经表达足够清楚。

练习验证 min 与 max 相等的情况,应总返回该边界;输入 NaN 应失败。新增测试应围绕业务边界,而不是机械覆盖每次赋值。函数参数与返回类型规则见 TypeScript 函数手册。

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

目录与阅读设置

阅读设置

17

记录一个想法

用工具函数收拢重复逻辑

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

登录哪都通