游戏规则、时序与画面的分层测试
适用:引擎无关的测试设计,客户端示例目标 Cocos Creator 3.8.8 + TypeScript;命令示例采用 Node 内置测试基础接口。资料核查:2026-11-17。自动化范围与微信设备验证分开记录。
游戏测试不等于一直点界面
后端经验能直接迁移到游戏规则测试:给定状态和输入,检查状态转移与业务不变量。区别在于游戏还受固定步时间、随机序列、输入持续状态和异步资源影响。若所有规则藏在节点回调中,测试只能启动整个引擎,反馈慢且难稳定。把伤害、冷却、掉落与局阶段提取为纯数据逻辑,就能先验证最重要的行为。
按风险分层:纯规则测试检查数学和状态;模拟回放检查一串输入;组件与场景集成检查模型到视图;平台替身检查接口结果如何影响业务;浏览器与真机检查真实输入、渲染和平台能力。它们不必数量均等,也不需要为每个属性写机械测试。优先覆盖奖励、胜负、资源生命周期与曾经失败的边界。
断言行为而不是抄实现
“调用函数后内部变量等于内部算法再算一次”很容易与实现共同出错。用玩家规则写独立预期:无敌期间不扣血、冷却未结束不能再次攻击、已结束的局不能继续发奖、同一操作只结算一次。测试名称直接说明行为,失败时能看出违反了哪条规则。私有函数是否被调用通常不如外部结果重要。
// rules.test.mjs;示例可用 node --test rules.test.mjs 运行。
import test from 'node:test';
import assert from 'node:assert/strict';
function damage(hp, amount, invulnerable) {
return invulnerable ? hp : Math.max(0, hp - amount);
}
test('无敌不扣血,致命伤害不会产生负生命', () => {
assert.equal(damage(10, 999, true), 10);
assert.equal(damage(10, 999, false), 0);
});
示例很小,是为了展示可运行的行为断言;正式项目应从业务模块导入实现,并增加非法输入的契约检查。不能只用这个测试就声称完整战斗已验证。伤害顺序、护盾、无敌结束边界、多个攻击同 tick 到达等规则,需要先由设计明确,再写测试;测试不能替你决定产品语义。
时间与随机数必须可以控制
冷却测试不应真的 sleep 数秒,而是推进固定逻辑步或注入可控制时钟。明确攻击发生在计时减少前还是后,边界 tick 用例最有价值。随机掉落使用可注入随机源或种子,失败时记录种子与输入。重跑同一条件仍随机变化的测试,很难区分真实错误与测试噪声。
回放记录初始状态、规则版本、种子和按 tick 排序的输入,定期计算规范化状态摘要。找到第一处差异后再比较具体字段。哈希不同只说明状态不同,不能自动说明网络或物理有错;字段顺序和不相关展示数据也可能影响摘要。只对需要确定性的模拟状态做规范化,镜头抖动和粒子不必进入胜负校验。
异步时序要主动排列
加载甲头像后立刻加载乙,让乙先完成;切场景后让旧请求返回;奖励提交后丢失响应;登录退出后旧认证到达。这些都适合用可手动 resolve 的 Promise 和替身接口测试,不需要等待真实网络碰运气。测试应控制“事件何时发生”,并断言旧结果不再影响当前对象。
对于广告、支付和分享,替身需覆盖成功、取消、失败、不支持与重复回调。替身证明业务分支与幂等,不能证明平台真实回调、账号准入或支付到账。让测试报告显式写出使用了哪个适配器,防止演示模式混进正式证据。服务端经济操作则需要实际事务与并发测试,单线程内存 Map 无法证明数据库约束正确。
画面测试要固定可比较条件
截图适合发现 UI 缺失、遮挡、文字溢出和资源丢失,但画面像素会受系统字体、浏览器、GPU、动画与随机数影响。固定分辨率、字体、种子、场景时刻与渲染设置,再建立基线。动态时钟、闪烁光标和粒子要冻结或选择稳定状态。失败后人工判断真实回归,不能无条件更新基线让检查变绿。
游戏 Canvas 的截图只说明画面,不说明内部胜负或按钮路径正确。配合只读调试快照,输出局阶段、角色生命、实体数量、输入状态和错误列表,可提高断言稳定性。调试接口不能允许正式客户端任意改资产,也不能把整个引擎对象树暴露给测试代码形成强耦合。
端到端闭环要短而有代表性
选择启动、进入首关、完成一次移动与攻击、暂停恢复、结算返回的短路径作为冒烟流程。再按风险添加失败恢复与关键设备场景。每个等待应依赖可观察状态,而不是固定等待几秒;固定等待过短会偶发失败,过长又拖慢反馈。遇到持续不稳定的测试先分析原因,不能只增加重试次数。
测试数据要可重置。局标识、账号状态、云存档与缓存会影响下一次运行,清理策略写进前置条件。经济测试用专用环境与账号,测试产物不能污染正式排行。浏览器自动化之后保留截图、控制台与场景快照,真机则按设备流程补足平台证据。
数据驱动关卡也要检查结构与语义
配置结构合法不代表关卡可玩。敌人出生点可能落在墙里,胜利目标引用不存在的实体,奖励表可能使用负数,下一关可能形成不可达循环。为资源清单和规则表写少量高价值静态检查,验证标识唯一、引用存在、数值范围与必要连通性,再在引擎中跑真实场景。
这些检查应表达内容契约,不能照着每个 JSON 字段机械生成断言。新增内容时错误能指出具体关卡和引用,策划与 AI 才能直接修正。无法静态判定的操作手感、可读性与难度仍要实际游玩,不要因配置测试全部通过就把它们一并写成已验证。
交给 AI 的任务与验收
可复制任务:“为伤害、冷却、局结束和奖励幂等写行为测试,时间按 tick 推进,随机数可注入。增加头像乱序、退出后登录迟到与重复广告结果的替身测试,再给首关闭环定义只读状态断言。不要测试私有实现,不用固定长 sleep 代替状态等待。”
验收每项测试能对应一条规则或历史缺陷;故意引入对应错误时会失败;同一回放可重复;截图差异可解释;报告区分纯逻辑、浏览器、开发工具与真机。绿色数量不是目标,关键行为是否受保护才是。
官方来源
- Node.js Test runner与严格断言:基础测试接口,使用时以项目 Node 版本为准。
- Playwright 视觉比较:截图基线与运行环境差异;本文不要求额外安装该工具。
- Cocos 3.8 预览调试:引擎预览与最终运行环境边界。