泛型约束违反:类型不满足 extends
快速摘要
你传递了不满足泛型参数 'extends' 约束的类型 —— TypeScript 拒绝它。
为什么发生
类型参数缺少约束要求的必需属性
类型参数是约束的超类型而非子类型
约束在调用处编写后被收紧,使之前有效的代码变为无效
最小示例
✗ 错误代码
function getProperty<T extends { id: number }>(obj: T) {
return obj.id;
}
getProperty({ name: 'test' }); // error: missing 'id' property✓ 修复代码
function getProperty<T extends { id: number }>(obj: T) {
return obj.id;
}
getProperty({ id: 1, name: 'test' }); // has 'id', satisfies constraint添加必需的 'id' 属性使对象满足泛型约束,解决编译错误。
如何诊断
阅读 TS 错误:'Type X does not satisfy the constraint Y' 并比较两个类型
检查泛型声明的 extends 约束并验证类型参数满足它
如果运行时类型正确但静态类型太窄则使用类型断言
如何修复
向类型参数添加缺失属性使其满足约束
如果约束过于限制性则放宽约束以接受需要传递的类型
如果运行时行为正确则使用类型断言或包装类型满足约束
如何预防
仔细设计泛型约束并记录期望满足的类型
收紧约束时更新所有调用处并使用编译器查找违规
相关资源
相关术语
相关课程
- 泛型
学习泛型约束。