第 15 / 17 篇
整理于 · 14 分钟
原型怎样不烂掉
先搭骨架不搭宫殿,还了哪些债,哪些目标没达到。
贯穿项目的约定 本篇涉及 1 条
GA 是一个三个多月里不停加系统的原型。武器、融合、背包、敌人、装备、局外,每条线都在往代码里加东西。这一篇讲武器阶段定下的一条开发规则,和按这条规则还债的过程:哪些债还了,哪些目标到现在也没有达到。
先搭骨架,不搭宫殿
武器阶段,武器、升星和融合在一周之内密集接进来,主场景脚本一度涨到 3014 行、196 个顶层函数,敌人脚本也有 2346 行、124 个函数。为此定了一条规则:先搭骨架,不搭宫殿。
意思是,可以提前把下一批功能要用的边界划好,但不提前设计遥远未来的完整框架;不为“以后可能需要”引入眼下没有人用的抽象;新的抽象必须服务当前或者接下来一两个明确的功能。目标是少一点“连续开发一阵,就被迫停下来大重构”。
中等以上的功能动手之前,先写清楚每一块归谁管:
- 主场景只做把各部分粘起来的事:分发输入、管节点的生命周期、管容器、接信号、刷新界面,和少量时序。
- 静态数据放进目录或定义文件。
- 玩法规则、星级规则、融合步骤、失败的提示文字,放进专门的规则模块,只输出计划和步骤。
- 查询世界的东西放进服务。
- 背包、装备、快捷栏的增删改,放进控制器或事务。
- 创建节点放进工厂。
- 计算效果的,放进专门执行步骤的执行器。
- 界面只展示和发请求,不拥有游戏规则。
判断一段代码该放在哪里,规则给的问法是:它是在计算发生了什么效果,还是只把请求转给负责的模块?前者一律不属于主场景。融合那条线的完成标准之一,就是主场景脚本里搜不到任何一个具体融合的分支。
规则也给了数字。一个正式脚本超过 800 行或 60 个顶层函数,必须收敛;超过 1200 行或 90 个函数是硬红线,不许再加功能,只能拆。主场景和敌人脚本当时已经过了硬红线,记成待还的历史债。默认的节奏是“功能、功能、架构收敛”,大约每两三个功能做一次小的收敛。
还列了一组不许出现的信号:主场景重新直接判断星级;新增从融合编号到战斗表现的映射;界面直接改规则;同一条规则同时写在规则模块和主场景里;为了修 bug 加一个兜底分支,却没有计划什么时候去掉它;新增零散的效果生成函数;模块之间拿没有类型的字典当约定。
武器阶段按这条规则收敛了好几轮。融合、升星、已装备的武器、炸罐部署、界面、攻击的几何、玩家的弹体、战刀和钩索的攻击、背包事务、玩家输入,陆续都有了自己的模块,从主场景手里接走了直接的规则。
代价也有记录。背包里的融合、拆解和升星改成事务以后,背包事务控制器从 635 行涨到 833 行,背包模型从 781 行涨到 831 行,两个文件都越过了 800 行;那一批做完,主场景是 3470 行、234 个函数。功能接进来了,债也跟着长了。
七月:规则层还健康,债集中在两个大文件
七月中旬做了一次盘点。敌人脚本 4240 行;主场景 3761 行、245 个函数,其中大约四成和武器、攻击有关;融合的规则模块 1297 行,判为健康;武器目录里一半是敌人和 Boss 的数据,算小债。结论是规则层整体健康,债集中在主场景和敌人脚本,目标分别降到 3000 行和 2500 行以内。
同时开了一张“不动”的清单:融合的步骤构建器、规则层、目录的数据驱动形态。步骤是用没有类型的字典表示的,判断是用检查结构的测试兜住它,不为它改结构。第一批抽出了攻击计划的执行器和 Boss 攻击的逻辑,拆开了敌人目录,主场景里写死的融合编号只剩 8 处。
楼层主脚本另有一份计划,近期目标是从 935 行、81 个函数降到 650 行、60 个函数以内。分四步做,每步单独验证,生存事件、Boss 流程这些逻辑搬进各自的桥接,文件降到 785 行、70 个函数。目标没有达到。处理方式是不为了追数字把范围扩大到 Boss、门和本来健康的地图模块,原来的完成条件记为不成立,只承认这几步做完了。从此改成一条 800 行的“棘轮”:历史上的热点文件,不许比最近一次确认的数字更大。行数只当哨兵,不当唯一的目标。
七月中旬还做过一次全项目审查。它衡量的不是净减了多少行,而是归属的数量、看不见的依赖、兜底分支和失败时事务的边界;明确不引入实体组件系统、依赖注入、服务定位器或者事件总线。一批没有挂进总入口的孤立测试被找出来单独跑,重新算进正式回归。
可是到七月下旬,同一份记录给出的数字和一周前差得很多:楼层主脚本从 785 行到了 1294 行,主场景从 3572 行到了 4462 行。这期间另有几项工作也做完了,这一批本身只是把背包的粘合代码从主场景搬到一个单独的控制器,记录里写的是“这一批不拿行数装瘦身”。
八月又收回了两处归属。地图模板原来在三个地方各选各的,整理后由地图的运行逻辑统一负责拓扑、随机数、房间类型和模板,三个旧的选择函数删掉。中断保存的逻辑散在主场景、商店和暂停里,收拢到一个检查点桥接,旧的快照方法一个不留,也不留兼容的空壳。
八月:一个面板一千多行
奖励箱的演示界面在八月下旬被查出主面板脚本大约 1117 行,超过 800 行的红线,卡住了全量回归。重新设计时定了硬规定:只能靠重新设计和拆职责解决,不许申请豁免、不许抬高红线,也不许把新文件登记成“历史基线”绕过去。
行数被归到职责堆在了一起:来源和权限的常量、开箱和揭示的状态、拿取的事务、两侧占格和找第一个能放的位置、拖放、全部的输入命中、全部的绘制,都在一个控件里。拆成六层:面板的生命周期和协调、会话、转移、负载的投影、渲染、布局。拆完主面板 444 行、41 个函数,对外的接口和常量不变。
界面不拥有规则
界面这条线守的是同一条规则:界面只展示、只发请求。
八月中旬,统一界面的第二版接进游戏,接法是可逆的:默认显示新界面,设一个环境变量就能退回旧界面;背后负责装备、背包、交易和套装规则的模块一个不换,数值一律不动。第二天把剩下的界面接上真实的功能,融合、升星、拆解和碎片合成都改成先弹确认,确认之前不改任何状态。
九月初的重构审查里有一项是界面的信息深度,展开成一条分步的路线:先给开始页、大厅、仓库与背包、奖励箱、商店与工坊、暂停、结算各自定好信息深度,从概览到执行分四级,写出交互的对照;再统一外壳和状态的表达,沿用已有的统一样式,不先引入新的主题框架;然后先修用户路径最重的背包和奖励箱,再修大厅和商店入口的语义。前几步在九月上旬做完:背包改成点击只查看,操作用原生按钮,确认层拦住其他输入;大厅的常驻入口收成仓库、天赋与成长、工坊三个,维修挪进工坊,摊位直接买和商人面板共用同一个购买入口。
九月:先审查,再动手
八月下旬以后很长一段时间没有新的提交。九月五日的重构机会审查是在这样的工作区上做的,这一轮只审查,源码只读。它列了九项:恢复测试统一到真正负责存档的入口;把主场景里玩家弹道的生命周期抽出去;敌人脚本里的内联状态分批迁出;背包界面的共用交互和旧版表现分开;退掉已经脱离正式流程的实验代码和旧的升星路径;把测试的清单和入口归属理清楚;修架构检查在计数上的盲区;校准入口文档;统一界面的信息深度。
几条发现能看出这份审查的写法。旧的恢复计划生成器只被一个测试用,正式流程走的是检查点桥接,两套计划的形状已经不一样了;审查写的是“检查的对象偏了,不等于已经证明游戏会丢档”。总入口里有一个测试被调用了两次,还在跑旧的升星逻辑。架构检查只数普通函数,漏掉了静态函数:融合的规则模块实际有 48 个函数,被算成 0 个;楼层主脚本离行数上限只差 1 行,另外有 20 行是用分号把几条语句压在一行里。
之后几天按审查分批动手。
第一批清理过度防御。代码里有一种写法,先探测依赖“有没有这个方法”再调用,依赖缺了就悄悄跳过,接线错了也看不出来。这一批删掉 27 处这样的探测,28 处调用改成直接调用。架构检查的函数计数改成连静态函数一起数。旧的恢复计划生成器退掉,恢复测试迁到正式的入口。
第二批把玩家弹道的生命周期从主场景搬出去。18 个函数移到一个新的控制器,主场景从 4566 行、280 个函数降到 4093 行、262 个函数;生成接口、融合步骤的格式、伤害数值和存档格式都不变。先在旧实现上跑生命周期的检查,重复结束、重置以后效果残留、目标失效时的转换这几个问题都复现了;新的控制器上没有。
第三批迁敌人脚本里的内联状态。原计划拿俯冲做试点,核对发现俯冲根本没有正式的使用者,第一刀改成了冲锋,第二刀是自爆,只迁自爆自己的状态,牵引、火焰冷却、物理和调度留在敌人脚本里。敌人脚本从 4735 行降到 4615 行。
第四批理测试的清单、修检查的盲区。这一批由协作方做完以后送验,被退回过一次:总入口又多出一处重复调用,检查在处理字符串里的三引号时会误判,把真函数漏数、把字符串里的假函数算进去。修完以后复验通过,架构检查还锁住了十几个压行文件里现有的分号数量,没有列出来的脚本默认一个都不许有。
九月十四日项目转向展示版,新计划把“没有展示需求的全仓去重、全面拆分主场景和敌人脚本”列为暂缓,只允许有明确使用者的局部调整。审查列的九项里,背包界面的分离、旧代码的退役和入口文档的校准,到这时还没有整批做完。
十月初的三个大文件
| 文件 | 十月初 | 架构检查的预算 | 七月定的目标 |
|---|---|---|---|
| 主场景脚本 | 4055 行、262 个函数 | 4093 行、262 个函数 | 3000 行以内 |
| 敌人脚本 | 4613 行、232 个函数 | 4615 行、233 个函数 | 2500 行以内 |
| 楼层主脚本 | 1304 行、93 个函数 | 1307 行、95 个函数 | 650 行、60 个函数以内 |
三个文件都在架构检查允许的范围内,离七月定的目标还很远。“先搭骨架,不搭宫殿”一直在用,几次审查都以归属和依赖为准,几种大框架被明确拒绝。