Skip to content

额外属性检查仅对对象字面量

快速摘要

你将带额外属性的变量赋值给类型 —— TypeScript 不检查变量的额外属性,只检查字面量。

为什么发生

  • 带拼写错误属性名的对象字面量先赋值给变量,绕过额外属性检查

  • 带额外属性的变量被传给函数,额外属性被静默允许

  • 你期望 TypeScript 捕获变量的额外属性,但它只检查对象字面量

最小示例

✗ 错误代码
interface Config { host: string; port: number; }
const config = { host: 'localhost', port: 8080, prot: 9000 }; // typo: 'prot'
function connect(c: Config) { /* ... */ }
connect(config); // no error! excess check skipped for variables
✓ 修复代码
interface Config { host: string; port: number; }
function connect(c: Config) { /* ... */ }
connect({ host: 'localhost', port: 8080, prot: 9000 }); // error: 'prot' does not exist in type 'Config'

将对象作为字面量传递触发 TypeScript 的额外属性检查,在编译时捕获拼写错误的 'prot' 属性。

如何诊断

  • 检查对象是作为字面量还是变量传递 —— 只有字面量获得额外属性检查

  • 手动比较对象属性与目标类型查找额外或拼写错误的属性

  • 使用类型断言或构造函数强制对变量进行额外属性检查

如何修复

  • 将对象作为字面量直接传给函数以触发额外属性检查

  • 使用接受确切类型并返回的工厂函数,强制调用者匹配类型

  • 使用模式验证库(zod)在运行时验证对象形状

如何预防

  • 尽可能直接传对象字面量给函数以免费获得额外属性检查

  • 使用工厂函数或构建器模式在构造时强制确切类型

相关资源

相关课程

← 返回语言