TypeScript构造签名与调用签名返回值不兼容的类型错误排查

你的代码报错核心在于普通函数无法直接匹配带有构造签名的接口，具体来说：

1. 接口CallOrConstruct定义了两种调用规则：

   • 作为构造函数调用：new CallOrConstruct(string) 返回 Person
   • 作为普通函数调用：CallOrConstruct(number) 返回 number

2. 你写的普通函数存在两个不符合接口要求的点：

   • 普通函数默认不支持new调用（除非手动处理new.target），无法满足构造签名的要求
   • 函数的参数是string | number、返回值是Person | number，这是联合类型，但接口要求的是两个独立的签名：当以普通函数调用时必须只接受number并返回number，当以构造函数调用时必须只接受string并返回Person。你的函数无法保证调用时参数和返回值的精准匹配，TypeScript会认为它不符合接口的每个单独签名。

方式一：手动实现支持两种调用的函数 #

通过判断new.target区分构造调用和普通函数调用，同时在内部做参数校验，最后用类型断言告诉TypeScript这个函数符合接口：

interface CallOrConstruct {
  new (value: string): Person
  (value: number): number
}

class Person {}

const User: CallOrConstruct = function (value: string | number): number | Person {
  // 构造调用场景
  if (new.target) {
    if (typeof value !== 'string') {
      throw new Error('构造调用必须传入字符串类型参数');
    }
    return new Person();
  } 
  // 普通函数调用场景
  else {
    if (typeof value !== 'number') {
      throw new Error('函数调用必须传入数字类型参数');
    }
    return value * 2;
  }
} as CallOrConstruct;

方式二：使用类结合静态方法（更符合TypeScript习惯） #

如果构造逻辑和函数逻辑可以分离，用类实现构造签名，静态方法实现函数调用签名：

interface CallOrConstruct {
  new (value: string): Person
  (value: number): number
}

class Person {}

class UserClass implements CallOrConstruct {
  constructor(value: string) {}
  
  static call(value: number): number {
    return value * 2;
  }
}

// 把类本身和静态方法绑定，让User同时支持构造和函数调用
const User = Object.assign(UserClass, UserClass.call) as CallOrConstruct;

TypeScript对多签名接口的匹配要求很严格：赋值的对象必须能分别满足每一个签名的要求，而不是用联合类型覆盖所有情况。这是为了保证调用时的类型安全，避免出现传入number却返回Person的情况。

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