Python 不支持传统函数重载，同名函数定义会覆盖前一个；可通过 args/*kwargs 判断、@singledispatch、typing.overload 或类分发等方式模拟。
Python 本身不支持传统意义上的函数重载（像 C++ 或 Java 那样基于参数类型或数量的多版本同名函数），但可以通过多种方式模拟类似行为。关键在于理解 Python 的动态特性和函数对象替换机制——它没有编译期重载解析，只有运行时的“后定义覆盖前定义”规则。
Python 中的“函数重载”为何不存在
在 Python 中，函数名本质上是变量，指向一个函数对象。当你在同一作用域内多次用 def 定义同名函数时，后一次定义会直接覆盖前一次的绑定，不会保留多个版本：
# 示例：
def add(a, b):
return a + b
def add(a, b, c):
return a + b + c
print(add(1, 2)) # TypeError: add() missing 1 required positional argument: 'c'
这里第二个 add 完全覆盖了第一个，解释器只认最后定义的三参数版本。
模拟重载的常用方法
虽然不能原生重载，但可通过以下方式实现按参数差异执行不同逻辑的效果：
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 使用 *args / **kwargs + 类型/数量判断：手动检查参数个数或类型，再分发逻辑（简单直接，适合轻量场景）
- @singledispatch 装饰器：标准库 functools 提供的单分派泛型函数，支持按第一个非 self 参数的类型分发（推荐用于类型导向的重载）
- 第三方库 typing.overload（仅类型提示）：配合 mypy 做静态类型检查时声明多个函数签名，但运行时仍需一个实际实现体（不是真重载，只是给工具看的“契约”）
- 类方法 + __dispatch__ 或自定义分发逻辑：在类中通过 __init__ 或属性控制行为分支，更面向对象
函数覆盖的真实机制
所谓“覆盖”，本质是名字空间（namespace）中的键值重新绑定：
- 模块级函数：在模块的 globals() 字典中，函数名作为 key，新函数对象作为 value 替换旧值
- 类中方法：在类的 __dict__ 中发生同样替换；实例调用时通过 MRO 查找，所以子类定义同名方法即覆盖父类
- 局部作用域（如嵌套函数）：每次执行外层函数都会重新创建内层函数对象，不存在跨调用的“残留重载”
这种机制简洁透明，但也意味着无法在运行时“回退”到被覆盖的旧函数——除非你提前保存引用。
实用建议：何时该用哪种方式
不必强求“重载”形式，优先选最清晰、易维护的方式：
- 参数差异小（比如可选参数）→ 直接用默认值或 *args
- 核心逻辑按输入类型变化（如处理 int/str/list）→ 用 @singledispatch
- 需要 IDE 或 mypy 提前发现调用错误 → 加 @overload 声明 + 实际实现函数
- 业务语义完全不同（如 load_config() vs load_config(path)）→ 拆成不同函数名，语义更明确
