跳到主要内容

TypeScript、JavaScript运行时与异步边界

本章不重复变量、循环和HTTP基础。游戏里值得特别注意的是:TypeScript类型会在运行时被擦除;JavaScript对象有引用与分配成本;异步结果可能返回到已经切换或销毁的场景;引擎脚本生命周期不会因为你写了async就自动等待。

类型不是外部数据验证​

const config = data as EnemyConfig只是告诉编译器相信你,并不会验证生命值是否存在、速度是否为有限数、单位是否正确。配置、存档、网络与远程资源都属于输入边界,应做实际校验。

type EnemyConfig={hp:number;speed:number};
function readEnemy(value:unknown):EnemyConfig {
if(typeof value!=='object'||value===null)throw new Error('enemy must be object');
const v=value as Record<string,unknown>;
if(typeof v.hp!=='number'||!Number.isInteger(v.hp)||v.hp<1)throw new Error('invalid hp');
if(typeof v.speed!=='number'||!Number.isFinite(v.speed)||v.speed<0)throw new Error('invalid speed');
return {hp:v.hp,speed:v.speed};
}

错误配置应在加载时失败并给出清晰位置,而不是运行数分钟后产生NaN坐标。对于编辑器序列化属性,类型与装饰器负责不同工作;要按Cocos版本使用属性定义,不能把普通TS字段自动当作可编辑资产引用。

用状态类型减少不可能组合​

type RunState=
| {kind:'loading';requestVersion:number}
| {kind:'playing';wave:number;hp:number}
| {kind:'finished';result:'won'|'lost';kills:number};
function canAttack(state:RunState){return state.kind==='playing'&&state.hp>0;}

这比同时维护 isLoading、isPlaying、isWon、isDead 多个独立布尔值更容易约束组合。但它不会自动解决所有时序:动画回调仍可能持有旧状态,异步加载仍可能在切场景后返回。类型帮助表达规则,生命周期机制负责执行。

异步返回需要归属与失效条件​

角色选择A后开始加载,立即选择B;若A较晚返回,不能覆盖B的当前表现。可使用递增请求版本,让旧结果失效。场景销毁时也要停止后续写入。

let requestVersion=0;
let alive=true;
async function selectCharacter(id:string){
const version=++requestVersion;
const asset=await loadCharacter(id); // 项目自己的异步资源封装
if(!alive||version!==requestVersion)return;
showCharacter(asset);
}
function dispose(){alive=false;requestVersion++;}

例子省略了资源引用释放;真实项目需要根据资源管理策略处理未采用的结果。AbortController也不能凭空取消一个不支持取消的引擎API,应按实际调用能力选择方案。

热路径的引用与分配​

每帧创建大量向量、数组、闭包或JSON会增加分配与GC压力。优先测量,再复用热点临时对象。Cocos向量方法有可变实例与输出参数等形式,调用前看清返回值和是否修改原对象。

同一配置对象被多个敌人引用时,如果运行中直接改它的hp,就可能修改所有实例共享的初始值。把只读配置与每个实体的运行状态分开。存档或网络快照也应明确是拷贝、引用还是可变对象,避免回放缓冲区里的历史快照被新帧覆盖。

模块与平台运行环境​

浏览器中的DOM、文件路径和第三方库默认行为不一定适用于微信。纯规则模块避免直接访问window、document和平台存储;由适配层把输入与输出接到环境。这样规则可以在Node测试、Canvas实验和Cocos表现之间复用。

不要为了“通用”提前构建多层平台框架。只有确实存在不同环境的边界才抽出来,例如存储、广告、时间来源和网络连接。函数输入输出应足够简单,方便测试与追踪。

AI任务与验收​

请检查这些TS脚本中的运行时风险:<路径>。
关注外部数据as断言、共享可变配置、异步返回到旧场景、每帧分配与DOM依赖。
每项给触发步骤与最小修正,保留现有架构。
加入坏配置、快速切换、销毁后返回和重复初始化的行为检查。

实际验收包括:坏数据在边界被拒绝;快速切换只显示最后选择;销毁后没有节点访问;长时间运行对象数与堆变化可解释;纯规则模块能离开引擎执行。

来源与版本​

核查日期2026-11-17,Creator3.8.8 / TypeScript5.9。