Python中Ellipsis作为返回类型的含义及优于typing.Any的原因

基本语义 #

在函数类型签名里写def my_function(a: int) -> ...:时，这个...（即Ellipsis）的核心语义和typing.Any几乎一致——类型检查器会将其视为任意类型，不对返回值做类型约束。但它的使用场景和传递的信号有明显区别。

优先于typing.Any的场景 #

• 临时占位用途：当你还未明确函数的返回逻辑、暂时无法确定返回类型，或者团队约定先搭建代码骨架再补充类型标注时，用...比Any更直观。它会清晰传递「这里的类型标注是临时的，后续需要完善」的信号，而Any容易被误解为「函数返回值确实可以是任意类型，无需修改」。
• 模糊类型的语义明确：如果函数返回值确实极度灵活（比如动态生成的对象、跨模块的复杂返回结构），但你不想用Any（因为Any会完全关闭该位置的类型检查约束），...在主流类型检查器（如mypy、pyright）中的行为和Any一致，但语义上更偏向「我明确知道这里类型模糊，并非有意放开所有检查规则」。

类型检查器的处理逻辑 #

像mypy、pyright这类主流工具，都会将返回位置的...等价于Any处理，不会触发额外的类型错误。但从代码可读性和团队协作的角度，...的「临时/待完善」信号更强，能减少不必要的沟通成本。

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