TypeScript：Java转TS处理方法重载的对象联合类型优化写法

我之前把老前端JS项目转TS的时候也碰到过一模一样的问题——既要让类型校验通过，又不想写一堆冗余的类型定义，分享几个我亲测好用的方案：

一、方法重载的优雅处理 #

你提到为了过TS校验只能用不太理想的写法，大概率是因为重载签名和实现签名重复定义了太多类型。其实可以通过提取公共类型+泛型条件类型来简化：

1. 基础重载+类型提取 #

如果你的方法只是参数/返回值的类型分支明确，先提取公共的类型集合，再写重载签名：

// 先提取所有可能的参数/返回类型
type ProcessableData = string | string[];

// 对外暴露的重载签名（明确每种输入对应的输出）
function processData(data: string): string;
function processData(data: string[]): string[];

// 实现签名只用提取好的公共类型，不用重复写联合
function processData(data: ProcessableData): ProcessableData {
  if (typeof data === 'string') {
    return data.toUpperCase();
  }
  return data.map(item => item.toUpperCase());
}

2. 泛型条件类型简化重载 #

如果输入和输出有严格的对应关系，甚至可以不用写多个重载签名，用条件类型让TS自动推导：

function processData<T extends string | string[]>(data: T): T extends string ? string : string[] {
  if (typeof data === 'string') {
    return data.toUpperCase() as ReturnType<typeof processData>;
  }
  return data.map(item => item.toUpperCase()) as ReturnType<typeof processData>;
}

// 使用时TS会自动推断返回值类型
const strResult = processData("hello"); // 类型是string
const arrResult = processData(["hello", "world"]); // 类型是string[]

二、无需重复定义的对象联合类型写法 #

对于有公共属性的对象联合类型，核心思路是提取公共基础类型，再用交叉类型拼接差异部分，完全避免重复写相同属性：

1. 基础方案：提取公共类型+交叉 #

// 先定义所有对象都有的公共属性
type BaseEntity = {
  id: string;
  createdAt: Date;
};

// 差异部分单独定义，再和基础类型交叉
type Admin = BaseEntity & {
  type: "admin";
  permissions: string[];
};

type RegularUser = BaseEntity & {
  type: "user";
  age: number;
};

// 最终联合类型只需要组合差异类型即可
type User = Admin | RegularUser;

2. 进阶方案：泛型判别式联合 #

如果你的联合类型是基于某个判别字段（比如type）来区分的，可以用泛型动态生成类型，扩展性更强：

type UserType = "admin" | "user";

// 用泛型绑定判别字段和差异属性的对应关系
type User<T extends UserType> = {
  id: string;
  createdAt: Date;
  type: T;
} & (T extends "admin" 
  ? { permissions: string[] } 
  : { age: number });

// 使用时直接指定判别类型即可
const admin: User<"admin"> = {
  id: "1",
  createdAt: new Date(),
  type: "admin",
  permissions: ["read", "write"]
};

const regularUser: User<"user"> = {
  id: "2",
  createdAt: new Date(),
  type: "user",
  age: 28
};

这种写法不仅不用重复定义公共属性，后续新增用户类型时，只需要扩展UserType和对应的条件分支即可，维护成本极低。

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