结构类型允许意外赋值
快速摘要
带额外属性的对象被赋值给属性更少的类型 —— 结构类型允许它,但可能隐藏 bug。
为什么发生
带额外属性的对象字面量被传给期望属性更少类型的函数
两个形状相同但语义不同的类型因结构类型而可互换
类型通过结构赋值被放宽,在额外属性上失去类型安全
最小示例
✗ 错误代码
interface User { id: number; name: string; }
interface Product { id: number; name: string; }
const user: User = { id: 1, name: 'Alice' };
const product: Product = user; // allowed! structurally identical
product.id = 999; // mutates user.id too!✓ 修复代码
type UserId = number & { __brand: 'UserId' };
interface User { id: UserId; name: string; }
interface Product { id: number; name: string; }
const user: User = { id: 1 as UserId, name: 'Alice' };
// const product: Product = user; // error: UserId is not assignable to number用幻影属性品牌化 UserId 类型防止其赋值给普通 number,避免结构类型陷阱。
如何诊断
检查对象是否有超出目标类型要求的属性 —— 它们被允许但可能非预期
使用品牌类型或名义类型模式防止语义不同类型互换
比较源类型和目标类型以理解哪些额外属性被静默携带
如何修复
使用品牌类型(type UserId = string & { __brand: 'UserId' })防止跨类型赋值
通过直接使用对象字面量(触发额外属性检查)而非变量添加额外属性检查
显式只选取需要的属性:const { a, b } = source; target = { a, b }
如何预防
对语义不同但结构相同的类型使用品牌类型
注意 TypeScript 使用结构类型 —— 从变量赋值时允许额外属性
相关资源
相关术语
相关课程
- 类型系统
学习结构类型。