游戏引擎 / 系统课时

完成代码检查与问题回归

完成代码检查与问题回归

脚本在正常路径能运行,还不足以说明事件清理、资源失败和旧结果覆盖都已解决。本节建立一份小而完整的回归入口,把移动、订阅与异步提交放进同一业务对象验证,再用独立清单检查 Cocos 场景接入,明确每项证据能证明什么。

学习目标

  • 执行严格类型检查并保存真实运行输出。
  • 回归移动、事件清理、加载失败和过期结果。
  • 区分纯逻辑通过与真实引擎场景验收。

固定回归输入与执行范围

把可复现问题保存成明确输入,不依赖“多点几次也许发生”。移动用固定时间片,重复监听用明确启停次数,异步竞态用可控 Promise 完成顺序。只覆盖关键业务边界,让失败能指向具体规则,而不是为了测试数量复制多个等价案例。

下面 Session 是完整纯 TypeScript 业务对象,事件集合代表内部动作通知,不是 Cocos Node 的替代实现。真实组件仍需使用 cc 的生命周期与事件 API。终端回归证明这些业务规则运行正确,不证明资源导入、Inspector 引用或引擎调度已经检查。

执行一个完整回归入口

文件:main.ts,strict 编译并运行 dist/main.js。check 会在规则不满足时抛错,程序不会继续打印通过。

ts
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; });

预期输出:

text
PASS movement
PASS event cleanup
PASS load failure
PASS stale result

把静态检查与运行证据分开保存

编译先采用 strict 与 noEmitOnError,只有无诊断时才运行本次产物。保存源码、入口文件、命令、工作目录、编译器版本、退出码和输出;修改代码后重新生成产物,避免旧 JavaScript 的正确输出遮住新 TypeScript 错误。

静态检查能阻止类型不兼容,却不能检查外部 JSON 的真实内容、Inspector 是否拖对节点或场景里是否挂了组件。异常回归能验证指定输入,却不能穷尽所有未来状态。每项证据都应对应一条具体规则,避免把“检查通过”解释成整个游戏绝不会失败。

刻意失败的类型示例应保存预期诊断编号与非零退出码,不能混进成功入口。正常入口的预期诊断应为空,让复查者能区分教学错误与交付缺陷。

在 Creator 中检查真实接入

  1. 确认组件脚本成功导入,活动节点与启用组件存在,Inspector 必需引用已配置。
  2. 在同一预览实例中反复启停,核对一次输入只带来一次业务动作,停用后不再响应。
  3. 使用真实正确资源与错误路径,分别检查成功显示、失败提示和旧表现保留。
  4. 离开场景或停用组件后,核对旧结果不会再改节点;场景切换也检查立即拒绝与异步失败。

以上步骤属于真实引擎验收,不能由本例 Set、Promise 或 TypeScript 编译结果代替。检查未执行时应明确记录“待 Creator 预览”,而不是写成通过。引擎生命周期规则见 Cocos 3.8 回调,类型检查边界见 语言支持。

回归问题要保留原触发条件

修复重复监听后保留对应启停序列;修复竞态后保留旧请求晚完成的顺序;修复外部数据后保留非法字段夹具。下次修改只重跑受影响边界与必要整体入口,不为简单变更扩展平台安装和导出验证。这样回归成本可控,失败时也更容易找到原因。

真正完整的交付应能说明代码如何检查、问题如何复现、修复后怎样观察,以及哪些真实引擎操作尚未执行。先让每条证据可靠,再决定是否增加更多功能,才能避免把一套可运行脚本重新变成不可解释的偶然组合。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成代码检查与问题回归

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

登录哪都通