JavaScript / TypeScript / 系统课时
排查类型不兼容
排查类型不兼容
面对一长串“不能赋值给”错误,最有效的方法不是从第一行开始猜,而是沿着错误信息不断向内读,找到最具体的那个类型差异。本篇用一个嵌套对象示例演示定位顺序,并扩展到联合类型、泛型参数和函数签名。
学习目标
- 从 TypeScript 错误链的最内层定位真正不兼容的类型
- 区分属性、联合分支、泛型参数和函数签名造成的差异
- 根据数据语义选择收窄、转换或修改类型,而不是强行断言
先找到最内层差异
假设接口模型允许邮箱为空,而视图模型要求邮箱一定是字符串。外层两个对象看起来几乎一样,但真正冲突发生在最深处的 email。
ts
type ApiUser = {
profile: {
contact: {
email: string | null;
};
};
};
type ViewUser = {
profile: {
contact: {
email: string;
};
};
};
const apiUser: ApiUser = {
profile: {
contact: {
email: null
}
}
};
const viewUser: ViewUser = apiUser;
console.log(viewUser);使用严格模式检查:
bash
tsc --strict --noEmit mismatch.ts预期结果会包含以下核心错误链;文件位置和措辞可能随 TypeScript 版本略有不同:
text
Type 'ApiUser' is not assignable to type 'ViewUser'.
The types of 'profile.contact.email' are incompatible between these types.
Type 'string | null' is not assignable to type 'string'.
Type 'null' is not assignable to type 'string'.真正要修的是最后一层:null 不能赋给 string。前面的 ApiUser、ViewUser、profile 和 contact 只是编译器逐层展开的定位路径。
按固定顺序缩小问题
看到类型不兼容时,可以按同一顺序处理:
- 先看最内层的两个类型,确认差异是缺少属性、字面量不同、
null/undefined、参数类型还是返回类型。 - 再沿错误链向外确认差异来自哪个属性或哪一层泛型。
- 回到数据语义,判断目标类型是否写得过窄,还是源数据确实需要转换。
- 修复后重新执行类型检查,避免用新的断言把错误隐藏起来。
识别四类常见根因
| 错误位置 | 常见信号 | 优先检查 |
|---|---|---|
| 对象属性 | Property ... is missing 或某字段类型不兼容 |
字段是否必选、是否允许空值 |
| 联合类型 | 某个分支无法赋值 | 是否先完成了类型收窄 |
| 泛型参数 | T、U 或容器元素类型不匹配 |
泛型约束和实际实参 |
| 函数签名 | 参数或返回值不兼容 | 参数能否接受更宽输入、返回值是否满足契约 |
函数类型尤其容易看反方向。一个只接受更窄参数的函数,通常不能冒充一个承诺接受更宽输入的函数;否则调用方可能传入它处理不了的值。遇到这类错误时,先比较每个参数位置,再看返回值,不要只盯着函数名。
用语义修复而不是用断言压掉错误
前面的示例有三种合理修复方向:如果视图本来就允许无邮箱,把目标字段改成 string | null;如果界面必须有字符串,在构造 ViewUser 前先收窄并拒绝空值;如果产品明确允许默认展示值,则在映射阶段把 null 转成约定的占位文本。
不推荐直接写 apiUser as ViewUser。这种写法不会改变运行时数据,只会让编译器停止提醒。排障的目标不是让红线消失,而是让源数据、转换逻辑和目标类型重新表达同一份真实语义。
按自己的节奏,确认真正理解。