Skip to content

结构类型允许意外赋值

快速摘要

带额外属性的对象被赋值给属性更少的类型 —— 结构类型允许它,但可能隐藏 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 使用结构类型 —— 从变量赋值时允许额外属性

相关资源

相关术语

相关课程

← 返回语言