游戏引擎 / 系统课时
从第一条编译错误开始定位
从第一条编译错误开始定位
编译器在多个调用处报错时,真正的原因可能只是上游对象字段类型写错。逐个改调用点会让协议越来越宽。本节从第一条诊断沿声明、赋值和使用位置追踪数据,保留一个可复现失败入口,再用正确的输入边界验证修复。
学习目标
- 根据文件、位置和编号定位错误表达式。
- 沿数据来源判断根因与后续影响。
- 用同一检查范围确认修复,而不是关闭类型约束。
固定入口与检查条件
先记录执行命令、工作目录、编译器版本与检查范围,确保两次结果可比较。直接传入文件只检查该文件及其依赖,项目模式则根据 tsconfig 包含文件。检查模式不同导致错误数量变化时,不能立即认定代码修复有效。
本例使用 TypeScript 5.9 的 strict 检查作为独立验收,代码语法保持 Creator 3.8 的兼容范围。真实 Cocos 项目仍需要正确的引擎类型上下文;找不到 cc 与业务参数错误是不同问题,不要为了消除模块错误临时声明一个假引擎。
从字段赋值找到根因
文件:broken.ts,完整的预期编译失败示例,在该目录执行 tsc broken.ts --strict --noEmit。
export {};
interface Role { hp: number; }
function display(role: Role): string { return role.hp.toFixed(0); }
// 错误发生在协议入口,不应把 display 参数改成 any。
const role: Role = { hp: '20' };
console.log(display(role));预期结果:编译退出码非零,TS2322 指向 hp 的字符串赋值,说明 string 不能赋给 number。此例不执行 JavaScript,不把类型失败程序当作成功输出。
TS2322: string 不能赋给 number从诊断位置向上看,Role 要求数值;向下看,display 要调用数值格式化方法。因此应修正或转换输入,不能只把 display 接收类型改宽。若代码使用推断类型,错误可能出现在调用处,此时仍要追到 role 的构造来源。
在正确边界转换输入
文件:main.ts,完整修复版纯 TypeScript 主例程,strict 编译后运行 dist/main.js。
export {};
interface Role { hp: number; }
function readHp(text: string): number {
// 文本转换后仍必须检查范围与有限性。
if (text.trim().length === 0) throw new Error('empty hp');
const hp = Number(text);
if (!Number.isFinite(hp) || hp < 0) throw new Error('invalid hp');
return hp;
}
function display(role: Role): string { return role.hp.toFixed(0); }
console.log(display({ hp: readHp('20') }));
try { readHp('bad'); }
catch (error: unknown) {
console.log(error instanceof Error ? error.message : 'unknown');
}预期输出:
20
invalid hp这里选择接受数值文本,是显式转换策略;如果字段来自 JSON 且协议要求 number,就应该拒绝字符串而非静默转换。排错首先要确认真实协议,不能为了让例子通过而随意改变输入含义。
重查剩余问题
修复根因后重新执行同一个命令,确认 TS2322 消失,再检查剩余诊断是否独立。若后续调用错误一起消失,可以认为它们由同一上游类型引起;若没有消失,应按新的第一条继续追踪。不要根据错误排序推断业务执行顺序,诊断列表不是运行日志。
如果第一条是括号缺失或语法解析错误,先修复它再分析类型诊断,因为后续位置可能已被错误解析影响。若第一条只是独立文件问题,也不能认为修复它必然解决所有其他文件;第一条是最短起点,根因仍需沿实际数据关系确认。
编辑器可能使用另一套 TypeScript 版本或项目配置,终端通过而编辑器仍报错时,核对打开的项目、使用的版本和文件包含范围。重启工具可以刷新状态,但不能替代解释根因。未保存文件也会使终端与编辑器读到不同内容,应先保存再比较。
确认修复没有降低约束
检查变更中是否引入 any、非空断言、双重断言或关闭 strict。它们并非永远禁止,但若只是用来绕过当前字段错误,就没有修复数据。修复应使正确输入通过、错误输入被拒绝,并保留 display 的准确参数协议。
本例的编译失败与修复后的运行输出提供两类证据:静态类型边界生效,文本转换失败路径也可观察。Creator 构建会忽略类型错误,因此预览成功不能代替独立检查。规则见 TypeScript 基础类型 与 Cocos 3.8 语言支持。