假设有这样一个函数:function handleOptions({} = {}) {},它在解构参数时使用了空对象模式,并且给了默认值。当你调用 handleOptions({ debug: true, retries: 3 }) 时,TypeScript 不会提示任何错误。这并不是因为 TypeScript 忽略了参数检查,而是空对象模式与默认值共同作用后,参数类型被推断成了 {},这个类型几乎接受所有非空值。理解这一行为需要从解构模式的类型推断机制说起。

一、解构模式如何参与类型推断
解构赋值不只是 JavaScript 的运行时语法,在 TypeScript 中它同时承担类型描述的作用。对于变量声明,类型推断通常直接来源于右侧表达式的类型。例如 const { name, version } = source 中,如果 source 的类型是 { name: string; version: string },那么 name 和 version 会分别推断为 string。解构模式本身不会改变源类型,它只是选择源类型中的某些属性并绑定到新变量。
函数参数里的解构则有所不同。如果没有显式类型注解,TypeScript 无法从调用侧反推参数类型,因为参数类型需要在函数声明阶段确定。因此在严格模式下,像 function handleOptions({}) {} 这样的写法会触发隐式 any 错误。要消除错误,要么提供显式类型注解,要么为解构参数提供默认值。默认值的类型会成为参数类型的推断依据。
const source = { name: 'TypeScript', version: '5.4' };
const {} = source; // 合法但没有实际绑定
function showVersion({ version }: { version: string }) {
console.log(version);
}
function implicitAnyVersion({ version }) {
// strict 模式下报错:参数隐式 any
console.log(version);
}
上面的 const {} = source 虽然看起来奇怪,但它合法。空对象模式没有创建任何变量绑定,所以这行代码几乎没有运行时效果。不过 TypeScript 仍然会评估右侧 source 的类型,只是不产生新的局部变量。在函数参数中,空对象模式也不会绑定任何变量,但类型推断仍然会作用于参数本身。
二、空对象默认值怎样让参数类型变成 {}
当函数写成 function handleOptions({} = {}) {} 时,解构模式是空对象,默认值是对象字面量 {}。对象字面量 {} 在 TypeScript 中的类型就是 {},它表示没有已知属性的类型。由于默认值参与参数类型推断,整个解构参数被赋予 {} 类型。于是函数声明等价于给参数加了一个 {} 注解。
接下来是关键问题:{} 类型到底能接受哪些值?在结构类型系统中,只要一个值的类型拥有目标类型要求的所有成员,就认为兼容。而 {} 不要求任何成员,所以除了 null 和 undefined 之外,几乎所有值都可以赋给 {}。这也包括原始类型,因为字符串、数字等值在 TypeScript 眼中同样具备可访问的成员。
function handleOptions({} = {}) {
console.log('options ignored');
}
handleOptions({ debug: true, retries: 3 }); // 通过
handleOptions('hello'); // 通过
handleOptions(100); // 通过
handleOptions(null); // strictNullChecks 下报错
从这个例子能看到,空对象解构并没有限制调用者必须传对象,更没有限制对象必须为空。传入字符串或数字同样被接受。如果业务意图是只接受真正的对象,这种写法就过于宽松。要想理解为什么字符串能赋给 {},可以把它类比为 Object 的成员访问:字符串有 length、toUpperCase 等成员,尽管 {} 不声明这些成员,但零成员要求总是满足。
三、{} 与 object、unknown 等类型的边界
很多开发者容易把 {} 与 object 混为一谈,实际上二者差异很大。object 表示非原始类型,也就是除 string、number、boolean、symbol、bigint 之外的值。原始值不能赋给 object,但可以赋给 {}。反过来,对象一定能赋给 {},也能赋给 object。
let empty: {};
empty = { name: 'x' }; // 通过
empty = 'hello'; // 通过
empty = 42; // 通过
let obj: object;
obj = { name: 'x' }; // 通过
obj = 'hello'; // 报错:string 不能赋给 object
obj = 100; // 报错:number 不能赋给 object
unknown 的范围比 {} 更宽,因为它接受 null 和 undefined。而 {} 在 strictNullChecks 开启时会拒绝这两个值。再看 Record<string, unknown>,它要求目标具有字符串索引签名,因此只有对象类型能满足,原始值会被拒绝。这些类型的宽窄关系大致可以理解为:unknown 最宽,{} 次之,object 又窄一些,而具体形状类型更窄。
空对象模式中推断出的 {} 与显式写的 {} 没有区别。因此即使把函数改成 function handleOptions(options: {}) {},调用 handleOptions({ debug: true }) 同样能通过。这提醒我们,不要把 {} 当作“空对象约束”,它只是“没有已知成员”的宽泛类型。
四、有属性绑定的解构默认值如何推断
如果解构模式里包含具体属性,默认值对推断结果的影响会更细致。例如 function readConfig({ host, port } = { host: 'localhost', port: 8080 }),参数类型并不会被推断成 { host: string; port: number },而是 { host?: string; port?: number }。原因是默认值只适用于整个参数,不代表调用者一定提供这些属性。TypeScript 通过将属性标记为可选来反映这种可能缺失。
function readConfig({ host, port } = { host: 'localhost', port: 8080 }) {
console.log(host.toUpperCase());
console.log(port.toFixed(2));
}
readConfig({ host: '127.0.0.1', port: 9090 }); // 通过
readConfig({}); // 通过,但运行时可能取默认值
如果默认值里没有属性,而模式里解构了属性,情况会变得危险。例如 function readConfig({ host, port } = {}),参数类型被推断为 { host?: unknown; port?: unknown } 或者更宽松的结果,此时在函数体内直接使用 host.toUpperCase() 可能报错。空对象模式之所以没有这种麻烦,正是因为它不绑定任何属性,函数体根本不会引用解构出来的值。
这也解释了为什么有人会用空对象解构来“占位”:在需要接收参数但又不使用参数内容时,给一个空对象解构和默认值可以避免隐式 any 错误。但从可读性看,这种写法会让调用者误以为需要传对象,实际上任何非空值都能通过检查。更好的方式是使用下划线参数名并显式给类型,比如 function handleOptions(_options: object = {}) 或直接使用 unknown。
五、实际场景中的规避写法
如果目标是定义一个可选配置对象,推荐使用接口或类型别名来描述参数形状。这样既能获得准确的属性提示,也能避免原始值被误传。例如:
interface Config {
debug?: boolean;
retries?: number;
}
function handleOptions({ debug = false, retries = 3 }: Config = {}) {
console.log(debug, retries);
}
handleOptions({ debug: true }); // 通过
handleOptions('hello'); // 报错:string 不能赋给 Config
这种写法把默认值放在解构属性级别,而不是整个参数级别。debug = false 和 retries = 3 在属性缺失时提供兜底,同时 Config 约束了调用者的传参形状。如果想强调参数必须是对象,可以把参数类型写成 object 或更具体的接口,但后者仍然是结构类型,无法阻止对象携带额外属性通过变量传入。
还应该注意,TypeScript 对对象字面量的额外属性检查只发生在直接赋值场景。若先把对象保存到变量再传参,额外属性会被忽略。因此真正的运行时约束仍然依赖参数校验或运行时解构逻辑。类型系统的作用是减少误用,而不是完全替代运行时检查。
空对象解构模式的行为可以总结为一句话:空模式不绑定属性,默认值 {} 使参数类型放宽为 {},从而接受几乎所有非空值。理解这一点后,就不会再对 function f({} = {}) 接受字符串、数字等值感到意外。需要严格约束参数时,务必提供显式类型注解或改用更具体的参数签名。
TypeScript类型推断解构赋值修改时间:2026-11-05 08:02:27