TypeScript中如何覆盖外部第三方库的函数类型签名？

你之前写的模块扩充声明只会和原有类型做合并，对于函数来说相当于新增了一个重载，原有的(key: string) => string签名依然有效，所以不会达到限制入参的效果。同时TypeScript默认会优先加载node_modules内自带的类型声明，你的自定义声明优先级不够也会被忽略。

推荐方案：封装 wrapper 函数（无配置成本、无类型冲突） #

直接在项目内封装一层工具函数，替换所有原包的导入使用，这是最稳妥不会出问题的方案：

// 你的项目里新建 utils/translate.ts
import { translate as rawTranslate } from 'translationpackage';

export function translate(key: 'foo' | 'bar'): string {
  return rawTranslate(key);
}

后续项目中统一导入你封装的translate即可，不用修改任何TS配置，也不会影响原包其他功能的类型。

方案二：全局覆盖原包类型（适合需要全项目替换原导入的场景） #

步骤1：创建自定义声明文件 #

在项目中新建自定义类型存放目录，比如src/types/overrides，在该目录下创建translationpackage.d.ts文件：

declare module 'translationpackage' {
  // 保留原包其他导出的类型
  export * from 'translationpackage';
  // 覆盖translate的类型，这里会直接替换原有签名
  export function translate(key: 'foo' | 'bar'): string;
}

步骤2：调整 tsconfig 优先级 #

打开tsconfig.json，修改compilerOptions配置，让TS优先加载你的自定义声明：

{
  "compilerOptions": {
    "paths": {
      // 指定解析translationpackage类型时优先用你写的声明文件
      "translationpackage": ["./src/types/overrides/translationpackage.d.ts"]
    },
    "include": [
      "src/**/*",
      // 确保自定义类型目录被TS扫描到
      "src/types/overrides/**/*"
    ]
  }
}

配置完成后重启TS服务，所有导入原包translate的位置都会应用你自定义的类型。

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