游戏引擎 / 系统课时
处理第一批类型报错
处理第一批类型报错
参数不匹配、属性未初始化和对象结构不完整,往往一起出现。直接添加 any 或感叹号虽能消除红线,却可能把问题带到预览。本节用一个刻意失败的小程序读取诊断,再修复数据流,建立先找根因、后检查运行结果的排错顺序。
学习目标
- 从文件、位置和诊断编号找到错误对应的表达式。
- 修复参数类型、属性初始化与返回结构问题。
- 区分“编译应失败”与“修复后应成功”的验证证据。
保留一个确定会失败的入口
文件:broken.ts,这是预期编译失败的完整示例,只执行类型检查,不运行生成物。在该目录执行 tsc broken.ts --strict --noEmit,退出码应非零;修复版则使用 strict 与 noEmitOnError 编译,避免错误代码生成产物后被误当作通过。
export {};
class Score {
// 缺少初始化是本例故意保留的错误。
value: number;
add(amount: number): void { this.value += amount; }
}
const score = new Score();
score.add('10');
// 对象缺少所需的 score 字段。
const result: { score: number } = { points: 10 };
console.log(result);预期结果:TypeScript 5.9 在 strict 模式下退出码非零,报告下面三个诊断;完整文字可能随版本变化,以编号和对应位置为准。
TS2564: value 未初始化
TS2345: string 实参不能赋给 number 形参
TS2353: points 不在目标对象类型中先看第一个诊断附近的声明,再追踪会读取它的方法。value 不初始化就参与加法,会把 undefined 带进计算。这里是内部计分对象,不依赖外部注入,最直接的修复是提供合理初始值。感叹号只让编译器相信赋值已完成,不负责赋值本身。
按数据流修复三个边界
字符串伤害或分数可能来自文本输入,需要明确转换并检查结果;内部固定常量则直接使用数值。对象字段冲突要回到协议确认名字,不能仅把变量类型改为 any。调用方和被调用方应共同遵守同一份结构,而不是分别接受两个拼写。
文件:main.ts,修复后的完整纯 TypeScript 主例程,单独严格编译并运行。
export {};
class Score {
private value = 0;
add(amount: number): void {
// 运行时仍拒绝非法数值,静态 number 不保证有限。
if (!Number.isFinite(amount) || amount < 0) {
throw new Error('invalid score');
}
this.value += amount;
}
snapshot(): { score: number } { return { score: this.value }; }
}
const score = new Score();
score.add(10);
// 对外返回新对象,避免暴露内部修改入口。
console.log(JSON.stringify(score.snapshot()));预期输出:
{"score":10}编译通过后再观察行为
修复后先重新执行 strict 检查,确认原诊断消失,再运行程序对照结果。若只看到没有红线,却没有运行正确入口,可能仍在使用旧编译产物。为每个示例保留独立目录,并确认执行的是本次编译生成的 dist/main.js。
在 Cocos 项目里,组件属性可能由 Inspector 注入;这种情况下应使用可空声明与运行时检查,而不是把“外部会赋值”理解为“绝不为空”。纯 TypeScript 类的 constructor 则适合集中建立内部不变量。两种初始化路径的根因不同,修复方式也应不同。
控制排错范围
遇到一串错误,先修复导致后续类型推断错误的声明或返回值,再重新检查,确认还有哪些独立问题。不要一次把所有类型改宽,否则失去判断哪个变更有效的证据。行号只是定位起点,真正的根因可能是上游函数返回了错误结构。
本例三个诊断彼此独立,初始化 value 不会顺带修好字符串参数或字段拼写。每修一项都应看到对应诊断消失,剩余诊断继续保留;若一次变更后三项突然消失,应检查是否误删了调用或关闭了 strict。消失的原因必须与修复动作对应。
检查命令也有范围边界:直接传入 broken.ts 只检查这个入口及其依赖,不会自动覆盖整个项目。实际项目使用原有 tsconfig 和项目检查命令,让包含范围与引擎类型声明正确参与。若单文件命令找不到 cc,先恢复项目上下文,而不是把引擎导入改成虚假的声明。
练习将修复版的 snapshot 字段改为 points,观察编译器如何在返回处阻止协议变化;恢复后再运行原入口。通过这条短链可以确认类型边界正在保护实际调用,而非仅消除编辑器标记。初始化规则见 TypeScript 类字段说明。