如何在TypeScript中为公有与私有静态方法定义重载？

在TypeScript里，不能直接定义同名的public static和private static方法——不管访问修饰符如何，同名的静态方法会被编译器判定为重复定义，导致报错。要实现「对外暴露一个公有静态方法，内部复用私有逻辑」的需求，结合方法重载可以这样做：

正确实现方式 #

1. 声明公有重载签名 #

先在类的公有区域声明对外可见的方法重载签名，明确对外暴露的参数类型。

2. 实现兼容所有重载的公有方法 #

写一个兼容所有重载签名的实现方法，在这个方法内部调用私有的逻辑处理方法（注意私有方法需要使用不同的名称，避免冲突）。

示例代码：

// 先定义示例类型
type ArgTypeA = { type: 'A', data: string };
type ArgTypeB = { type: 'B', value: number };

export class MyClass {
    // 1. 对外暴露的重载签名（公有）
    public static methodX(arg: ArgTypeA): void;

    // 2. 实现兼容所有重载的方法（必须是公有，且参数类型兼容所有重载）
    public static methodX(arg: ArgTypeA | ArgTypeB): void {
        // 根据参数类型分发到私有逻辑方法
        if (arg.type === 'A') {
            MyClass.#methodXImpl(arg);
        } else {
            MyClass.#methodXImpl(arg);
        }
    }

    // 私有静态方法，处理核心逻辑（用不同名称避免冲突）
    private static #methodXImpl(arg: ArgTypeA | ArgTypeB): void {
        if (arg.type === 'A') {
            console.log(`处理类型A: ${arg.data}`);
        } else {
            console.log(`处理类型B: ${arg.value}`);
        }
    }
}

为什么不能直接写同名的公有/私有静态方法？ #

TypeScript的方法重载机制要求：重载签名只是对外的类型声明，实际的实现只能有一个。如果同时定义public static methodX和private static methodX，编译器会认为这是两个重复的方法定义，而不是重载——因为重载是「同一方法的不同参数类型声明」，而不是「不同访问修饰符的同名方法」。

简化场景：对外仅接受单一参数类型 #

如果你的需求是对外只接受ArgTypeA，内部调用处理ArgTypeB的私有逻辑，可以简化代码：

type ArgTypeA = { data: string };
type ArgTypeB = { value: number };

export class MyClass {
    public static methodX(arg: ArgTypeA): void {
        // 将ArgTypeA转换为ArgTypeB，再调用私有方法
        const argB: ArgTypeB = { value: parseInt(arg.data) };
        MyClass.#methodX(argB);
    }

    private static #methodX(arg: ArgTypeB): void {
        console.log(`处理类型B: ${arg.value}`);
    }
}

这里私有方法用了TypeScript 3.8+支持的私有字段语法（#methodX），比private修饰符的访问限制更严格。

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