TypeScript如何实现依赖接口子集？自定义Logger适配Winston问题

这个问题的核心在于TypeScript对函数重载的匹配逻辑：你的LogMethod实现是一个单一签名的函数（接受string | object），但Winston的LeveledLogMethod是多重载签名，TS无法自动将单一联合参数的函数与多重载接口对齐，导致报错。

正确的解决方案：使用函数重载实现LogMethod #

我们需要为自定义Logger的每个方法（debug/info/error）显式声明重载签名，让TS能明确匹配到Winston支持的调用方式，同时在实现中通过类型区分来调用对应的Winston方法。

步骤1：明确LogMethod的重载接口

保持你的LogMethod接口定义不变，它已经明确了我们需要支持的两种调用形式：

interface LogMethod {
  (message: string): void;
  (infoObject: object): void;
}

步骤2：在自定义Logger类中实现重载方法

在类中先声明与LogMethod一致的重载签名，再编写包含类型判断的实现逻辑：

import winston from 'winston';

class CustomLogger {
  private logger: winston.Logger;

  constructor(logger: winston.Logger) {
    this.logger = logger;
  }

  // 声明debug方法的重载签名，完全匹配LogMethod
  debug(message: string): void;
  debug(infoObject: object): void;
  // 实现签名：内部处理参数类型分支
  debug(arg: string | object): void {
    if (typeof arg === 'string') {
      // 这里arg是明确的string，匹配Winston的(message: string, ...meta: any[])重载
      this.logger.debug(arg);
    } else {
      // 这里arg是明确的object，匹配Winston的(infoObject: object)重载
      this.logger.debug(arg);
    }
  }

  // 同理实现info方法
  info(message: string): void;
  info(infoObject: object): void;
  info(arg: string | object): void {
    if (typeof arg === 'string') {
      this.logger.info(arg);
    } else {
      this.logger.info(arg);
    }
  }

  // 同理实现error方法
  error(message: string): void;
  error(infoObject: object): void;
  error(arg: string | object): void {
    if (typeof arg === 'string') {
      this.logger.error(arg);
    } else {
      this.logger.error(arg);
    }
  }
}

为什么这个方法有效？ #

1. 重载签名对齐：我们声明的重载签名完全匹配LogMethod的要求，同时每个签名都能精准对应WinstonLeveledLogMethod中的有效重载（避开了我们不需要的callback/meta参数形式）。
2. 类型窄化：在实现中通过typeof判断参数类型，将string | object的联合类型窄化为单一类型，此时TS能明确识别出调用Winston方法时匹配的是哪个重载，不会再抛出类型不匹配的错误。

这种方式既符合TypeScript的类型检查规则，又严格遵循了你对自定义Logger的功能限制，不需要使用// @ts-ignore或类型断言来绕过检查。

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