函数默认参数中的省略号(...)作用是什么？以Pandas to_csv为例

问题背景 #

在Pandas源码的to_csv函数重载定义中，部分参数的默认值写为...，代码片段如下：

@overload
def to_csv(
    self,
    path_or_buf: FilePath | WriteBuffer[bytes] | WriteBuffer[str],
    sep: str = ...,
    na_rep: str = ...,
    float_format: str | Callable | None = ...,
)

请问这里的...作为函数默认参数时，具体代表什么含义？

核心解答 #

这里的...是Python内置的Ellipsis对象，在带类型注解的函数重载（@overload）场景下，作用分为两点：

• 作为默认值占位符：重载定义仅用于声明函数的签名、参数类型和可选性，不需要实现函数逻辑，因此用...代替实际的默认值（比如sep的真实默认值是逗号,），既满足类型检查的规范，又避免在多个重载定义中重复维护相同的默认值。
• 标记参数为可选：明确告知类型检查工具（如mypy），该参数是可选的，调用函数时可以不传入，函数会使用预设的真实默认值执行。

需要注意的是，这种用法仅适用于@overload修饰的类型声明函数，普通可执行函数中如果把...设为参数默认值，运行时会触发错误。

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