@overload

`@overload` 是 Python 中的一个装饰器，用于实现函数或方法的重载。如果一个函数或方法有多个不同参数类型或参数个数的版本，可以使用 `@overload` 来标记这些不同的版本，从而提高代码的可读性和可维护性。

使用 `@overload` 装饰器的函数或方法通常都会有一个实现的基础版本，也就是参数类型和个数最少的版本。其他版本的实现则通过 `@overload` 标记来声明，但是这些标记的方法体内容并不会被执行。这是因为 `@overload` 装饰器只是用于标记函数或方法的不同版本，而不是实际的实现。

下面是一个简单的示例，演示如何使用 `@overload` 实现重载函数：

from typing import overload

@overload
def foo(x: int) -> int:
    ...

@overload
def foo(x: str) -> str:
    ...

def foo(x):
    if isinstance(x, int):
        return x + 1
    elif isinstance(x, str):
        return x.upper()

在这个例子中，`foo` 函数有两个不同的版本，分别接受一个整数和一个字符串。这两个版本都被使用 `@overload` 标记来声明。但是，真正的实现是在最后的 `foo` 函数中，它根据不同的参数类型来执行相应的逻辑。

需要注意的是，在 Python 中实际上并没有方法重载的概念。因此，`@overload` 装饰器只是一种语法糖，用于增强代码的可读性和可维护性。