额外属性检查仅对对象字面量
快速摘要
你将带额外属性的变量赋值给类型 —— 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)在运行时验证对象形状
如何预防
尽可能直接传对象字面量给函数以免费获得额外属性检查
使用工厂函数或构建器模式在构造时强制确切类型
相关资源
相关术语
相关课程
- 类型系统
学习类型检查。