游戏引擎 / 系统课时
完成代码检查与问题回归
完成代码检查与问题回归
脚本在正常路径能运行,还不足以说明事件清理、资源失败和旧结果覆盖都已解决。本节建立一份小而完整的回归入口,把移动、订阅与异步提交放进同一业务对象验证,再用独立清单检查 Cocos 场景接入,明确每项证据能证明什么。
学习目标
- 执行严格类型检查并保存真实运行输出。
- 回归移动、事件清理、加载失败和过期结果。
- 区分纯逻辑通过与真实引擎场景验收。
固定回归输入与执行范围
把可复现问题保存成明确输入,不依赖“多点几次也许发生”。移动用固定时间片,重复监听用明确启停次数,异步竞态用可控 Promise 完成顺序。只覆盖关键业务边界,让失败能指向具体规则,而不是为了测试数量复制多个等价案例。
下面 Session 是完整纯 TypeScript 业务对象,事件集合代表内部动作通知,不是 Cocos Node 的替代实现。真实组件仍需使用 cc 的生命周期与事件 API。终端回归证明这些业务规则运行正确,不证明资源导入、Inspector 引用或引擎调度已经检查。
执行一个完整回归入口
文件:main.ts,strict 编译并运行 dist/main.js。check 会在规则不满足时抛错,程序不会继续打印通过。
export {};
type MoveHandler = (active: boolean) => void;
class Session {
x = 0;
asset = 'placeholder';
private active = false;
private moving = false;
private version = 0;
private handle: MoveHandler = value => { this.moving = value; };
constructor(private bus: Set<MoveHandler>) {}
enable(): void { this.active = true; this.bus.add(this.handle); }
disable(): void {
this.active = false; this.moving = false;
this.bus.delete(this.handle); this.version++;
}
tick(dt: number): void {
if (!Number.isFinite(dt) || dt < 0) throw new Error('invalid dt');
if (this.active && this.moving) this.x += 100 * dt;
}
async load(task: Promise<string>): Promise<string> {
const request = ++this.version;
try {
const asset = await task;
// 业务结果只允许当前活动会话提交。
if (!this.active || request !== this.version) return 'stale';
this.asset = asset; return 'ready';
} catch (error: unknown) {
return !this.active || request !== this.version ? 'stale' : 'failed';
}
}
}
function check(condition: boolean, label: string): void {
if (!condition) throw new Error(`FAIL ${label}`);
console.log(`PASS ${label}`);
}
function deferred(): { promise: Promise<string>; resolve: (value: string) => void } {
let resolve!: (value: string) => void;
const promise = new Promise<string>(ok => { resolve = ok; });
return { promise, resolve };
}
async function main(): Promise<void> {
const bus = new Set<MoveHandler>();
const session = new Session(bus);
session.enable(); session.enable();
for (const handle of [...bus]) handle(true);
session.tick(0.25); session.tick(0.75);
check(session.x === 100 && bus.size === 1, 'movement');
session.disable(); session.tick(1);
check(bus.size === 0 && session.x === 100, 'event cleanup');
session.enable();
const failed = await session.load(Promise.reject(new Error('missing')));
check(failed === 'failed' && session.asset === 'placeholder', 'load failure');
const old = deferred(), latest = deferred();
const a = session.load(old.promise), b = session.load(latest.promise);
latest.resolve('new'); await b;
old.resolve('old');
check(await a === 'stale' && session.asset === 'new', 'stale result');
}
void main().catch((error: unknown) => { throw error; });预期输出:
PASS movement
PASS event cleanup
PASS load failure
PASS stale result把静态检查与运行证据分开保存
编译先采用 strict 与 noEmitOnError,只有无诊断时才运行本次产物。保存源码、入口文件、命令、工作目录、编译器版本、退出码和输出;修改代码后重新生成产物,避免旧 JavaScript 的正确输出遮住新 TypeScript 错误。
静态检查能阻止类型不兼容,却不能检查外部 JSON 的真实内容、Inspector 是否拖对节点或场景里是否挂了组件。异常回归能验证指定输入,却不能穷尽所有未来状态。每项证据都应对应一条具体规则,避免把“检查通过”解释成整个游戏绝不会失败。
刻意失败的类型示例应保存预期诊断编号与非零退出码,不能混进成功入口。正常入口的预期诊断应为空,让复查者能区分教学错误与交付缺陷。
在 Creator 中检查真实接入
- 确认组件脚本成功导入,活动节点与启用组件存在,Inspector 必需引用已配置。
- 在同一预览实例中反复启停,核对一次输入只带来一次业务动作,停用后不再响应。
- 使用真实正确资源与错误路径,分别检查成功显示、失败提示和旧表现保留。
- 离开场景或停用组件后,核对旧结果不会再改节点;场景切换也检查立即拒绝与异步失败。
以上步骤属于真实引擎验收,不能由本例 Set、Promise 或 TypeScript 编译结果代替。检查未执行时应明确记录“待 Creator 预览”,而不是写成通过。引擎生命周期规则见 Cocos 3.8 回调,类型检查边界见 语言支持。
回归问题要保留原触发条件
修复重复监听后保留对应启停序列;修复竞态后保留旧请求晚完成的顺序;修复外部数据后保留非法字段夹具。下次修改只重跑受影响边界与必要整体入口,不为简单变更扩展平台安装和导出验证。这样回归成本可控,失败时也更容易找到原因。
真正完整的交付应能说明代码如何检查、问题如何复现、修复后怎样观察,以及哪些真实引擎操作尚未执行。先让每条证据可靠,再决定是否增加更多功能,才能避免把一套可运行脚本重新变成不可解释的偶然组合。