如何在TypeScript普通对象中实现方法重载？解决赋值报错

要解决这个错误，核心是让对象中实现的函数兼容所有重载签名。TypeScript要求对象的方法实现必须能被所有声明的重载方式调用，你的代码报错是因为当前func的实现只匹配了第二个重载，无法处理第一个单参数的调用场景。

方法一：兼容所有重载的函数实现 #

直接编写一个能覆盖所有重载参数的函数，通过类型守卫在内部区分不同调用场景：

type Foo = {
  func(a: string): void;
  func(b: number, a: string): void;
}

const f: Foo = {
  func(a: string | number, b?: string) {
    // 处理第一个重载：单字符串参数
    if (typeof a === 'string') {
      console.log(`接收字符串: ${a}`);
      return;
    }
    // 处理第二个重载：数字+字符串参数
    if (typeof a === 'number' && typeof b === 'string') {
      console.log(`接收数字: ${a}, 字符串: ${b}`);
    }
  }
}

方法二：显式声明函数重载签名 #

如果想更清晰地对应重载定义，可以用函数表达式的方式，先声明重载签名再写实现：

type Foo = {
  func(a: string): void;
  func(b: number, a: string): void;
}

const f: Foo = {
  func: function(a: string): void;
  func(b: number, a: string): void;
  func(a: string | number, b?: string) {
    // 内部实现逻辑同上
    if (typeof a === 'string') {
      console.log(`接收字符串: ${a}`);
    } else if (typeof a === 'number' && b) {
      console.log(`接收数字: ${a}, 字符串: ${b}`);
    }
  }
}

关键说明 #

• 两种方式的核心都是确保实现函数能处理所有重载的调用情况：
  • 第一个重载调用f.func("hello")时，a为字符串，b为undefined，会进入对应的处理分支；
  • 第二个重载调用f.func(123, "hello")时，a为数字，b为字符串，进入另一分支。
• 不要省略参数类型标注，否则TypeScript会错误推断参数类型，导致和重载签名不兼容（这也是你最初报错的原因）。

内容的提问来源于stack exchange，提问作者Yanick Rochon