Skip to content

泛型约束违反:类型不满足 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 约束并验证类型参数满足它

  • 如果运行时类型正确但静态类型太窄则使用类型断言

如何修复

  • 向类型参数添加缺失属性使其满足约束

  • 如果约束过于限制性则放宽约束以接受需要传递的类型

  • 如果运行时行为正确则使用类型断言或包装类型满足约束

如何预防

  • 仔细设计泛型约束并记录期望满足的类型

  • 收紧约束时更新所有调用处并使用编译器查找违规

相关资源

相关术语

相关课程

← 返回语言