TypeScript封装第三方库：如何避免复制维护原类型及重载？

你碰到的这个问题我太懂了——手动复制维护第三方库的类型和重载不仅麻烦，还容易在原库更新时出现类型不一致的问题。其实TypeScript提供了非常巧妙的方式来自动复用原函数的所有类型定义，不用手动写一行类型代码。

核心方案：用typeof直接复用原函数类型 #

最直接的方法就是通过typeof获取原函数的完整类型（包括所有重载），然后赋值给你的封装函数。这样你的封装函数会自动继承原函数的所有类型信息，完全不用手动复制重载或参数类型。

举个你提到的date-fns的format函数的例子：

import { format as _format } from 'date-fns';

// 直接复用原format函数的所有类型（包括重载）
export const format: typeof _format = (date, formatStr, options) => {
  // 这里可以添加你的自定义逻辑，比如参数校验、日志埋点等
  console.log('调用了封装后的format函数');
  return _format(date, formatStr, options);
};

这样写之后，你的format函数会和原date-fns的format拥有完全一致的类型提示、重载支持，甚至原库更新类型后，你只需要升级依赖，类型会自动同步，完全不用手动维护。

进阶：封装整个模块时的处理 #

如果你需要封装整个第三方库（而不只是单个函数），可以先导出原库的所有内容，再单独覆盖需要修改的函数：

import * as dateFns from 'date-fns';

// 导出原库的所有内容，保留原类型
export * from 'date-fns';

// 单独封装format函数，复用原类型
export const format: typeof dateFns.format = (date, formatStr, options) => {
  // 自定义逻辑
  return dateFns.format(date, formatStr, options);
};

这种方式下，其他未修改的函数（比如addDays、parseISO等）会直接复用原库的类型，你只需要处理需要封装的函数即可。

注意事项 #

• 如果你的封装函数需要修改参数（比如添加默认值），要确保参数类型和原函数兼容。比如原函数的第二个参数是必填的，你添加默认值后，TypeScript会自动识别这个参数变为可选，同时保留原有的重载逻辑。
• 如果你需要对原类型做微调（比如修改某个参数的类型），可以结合TypeScript的工具类型（比如Parameters、ReturnType、Omit等）来处理，但这种情况比较少见，大部分场景下直接用typeof就足够了。

这种方法的最大优势就是零手动类型维护，完全依赖TypeScript的类型推导能力，既减少了工作量，又避免了手动复制类型带来的错误。

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