TypeScript中如何将联合类型传入重载函数？求更优方案

你的问题核心在于TypeScript的重载机制：对外暴露的重载签名不包含联合类型的情况，虽然实现签名支持string | string[]，但TS只会匹配你声明的重载，不会自动关联到实现签名。下面是几个更简洁的优化方案：

方案1：补充联合类型的重载签名 #

直接给initData加一个接受联合类型的重载签名，让TS能直接匹配到：

type Params = {
    data: string | string[]
}

class Test {
    data: string | string[]

    constructor(params: Params) {
        this.data = this.initData(params.data) // 现在不会报错了
    }

    // 新增联合类型的重载签名
    initData(data: string | string[]): string | string[]
    initData(data: string): string
    initData(data: string[]): string[]
    initData(data: string | string[]): string | string[] {
        if (typeof data === 'string') {
            return data
        } else {
            return data
        }
    }
}

这样既保留了重载的明确性，又能直接处理联合类型的参数，不需要额外的分支判断。

方案2：移除重载，改用泛型 #

如果你的initData逻辑只是简单返回输入（像当前实现这样），完全可以用泛型替代重载，让TS自动推导类型关联：

type Params = {
    data: string | string[]
}

class Test {
    data: string | string[]

    constructor(params: Params) {
        this.data = this.initData(params.data)
    }

    initData<T extends string | string[]>(data: T): T {
        return data
    }
}

这种方式更简洁，避免了重载的冗余，同时保证了输入输出的类型一致性。

方案3：类型断言（极简但不推荐） #

如果不想修改initData，也可以在调用时用类型断言跳过TS的检查：

constructor(params: Params) {
    this.data = this.initData(params.data as string | string[])
}

不过这种方式相当于绕过了TS的类型检查，不如前两种方案安全，只适合临时快速解决。

对比你现有的分支判断方案，前两种方案不需要重复的条件判断，代码更简洁易维护，推荐根据你的实际业务逻辑选择：如果initData未来会有更复杂的分支逻辑，方案1更合适；如果逻辑简单，方案2更优雅。

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