游戏客户端架构 / 系统课时
组件复用边界怎么判断
组件复用边界怎么判断
游戏 UI 做久以后,很容易陷入两个极端:所有页面都复制一份,修改一次要改很多处;或者任何相似元素都抽成“万能组件”,最后参数比业务逻辑还复杂。本节建立一套可执行的判断方法,让复用发生在稳定边界,而不是表面相似处。
学习目标
- 判断一段 UI 是否值得抽成可复用组件
- 区分视觉复用、行为复用与业务复用的不同边界
- 识别过度抽象,并知道什么时候应该保留重复
先判断什么真的在重复
看到两个按钮长得一样,并不意味着它们必须使用同一个业务组件。判断复用价值时,先拆成三个维度:视觉结构、交互行为和业务语义。
| 维度 | 典型问题 | 适合复用的信号 |
|---|---|---|
| 视觉结构 | 布局、字体、图标位置是否稳定 | 多处长期保持同一种视觉规则 |
| 交互行为 | 点击、选中、禁用、冷却等行为是否一致 | 状态机和输入输出基本相同 |
| 业务语义 | 是否都表示同一个业务概念 | 数据字段和业务规则也稳定一致 |
例如背包里的“物品格”和技能栏里的“技能格”都可能是图标、数量和边框组成的方块。它们可以共享底层的槽位视觉能力,但不一定应该共享“使用物品”“技能冷却”“拖拽交换”等业务逻辑。

把稳定变化轴留在组件内部
一个组件是否好复用,关键不是“现在有几处使用”,而是这些使用方未来会不会沿同一条变化轴演进。
假设三个界面都有奖励卡片。如果它们只是奖励名称、图标、数量不同,而布局与交互长期一致,那么这些差异适合作为组件输入。反过来,如果活动奖励要显示领取倒计时,任务奖励要显示完成条件,商城礼包还包含价格和折扣,把三者强行塞进一个组件通常会不断增加开关参数。
组件应该隐藏稳定的实现细节,同时把真正会变化的信息暴露为输入。若调用方必须了解组件内部大量状态才能正确使用它,这个边界通常已经不够独立。
不要把业务差异伪装成配置项
过度抽象最常见的表现,是一个组件拥有大量类似 showPrice、showTimer、enableDrag、isQuestMode、isShopMode 的开关。每增加一个场景,就增加一组互相约束的参数,最终形成隐式的业务分支矩阵。
这类组件虽然“只写了一份”,但维护成本并没有减少。开发者仍然需要知道不同模式允许哪些参数组合,而且修改商城逻辑时还可能意外影响背包或任务界面。
更稳妥的方式是把真正通用的视觉和交互能力下沉,例如统一的图标槽位、选中态边框、数量文本,再让背包、技能和商城分别拥有自己的业务组件。重复几行简单的组合代码,通常比维护一个拥有十几个模式的万能组件更便宜。
用三个问题决定要不要抽组件
准备提取组件时,可以依次检查:
- 结构是否稳定重复。 如果只是暂时长得相似,而布局很快会分化,不急着抽。
- 变化原因是否一致。 如果多个使用方通常会因为同一种需求一起修改,适合共享;如果它们由不同业务规则驱动,应保持独立。
- 接口是否能保持简单。 如果提取后只需要少量清晰输入和事件输出,复用价值较高;如果需要大量模式开关和调用顺序约束,应重新划分边界。
第一次出现重复时不一定立即抽象。对于仍在快速迭代的 HUD,保留两份小规模重复代码,观察第二次、第三次变化后再确定公共部分,往往能得到更准确的边界。
好的复用不是让项目里的组件数量最少,而是让每个组件只有少数明确的变化原因。基础能力尽量稳定复用,业务语义保持独立,才能在界面持续增加时避免“改一个组件,多个页面一起出问题”。