Python中函数作为参数传入的类型提示及方法类型提示问题

1. 函数参数的正确类型提示 #

你不能直接用function作为类型提示——虽然控制台里type(function_2)会返回function，但这是函数对象的类型标识，并非Python标准库中可直接用于类型注解的合法类型，所以IDE会报错要求导入。正确的做法是使用Callable类型：

兼容Python 3.5+的写法 #

从typing模块导入Callable，并明确标注参数类型和返回值类型：

from typing import Callable

def function_1(x: str) -> str:
    return x + ' world'

def function_2(function: Callable[[str], str]) -> str:
    return function('hello')

function_2(function_1)  # 类型检查正常通过

• Callable[[参数类型列表], 返回值类型]：[str]表示该函数接受一个str类型参数，str表示返回值为str类型。

Python 3.9+推荐写法 #

直接使用标准库collections.abc中的Callable，无需额外依赖：

from collections.abc import Callable

def function_1(x: str) -> str:
    return x + ' world'

def function_2(function: Callable[[str], str]) -> str:
    return function('hello')

如果不需要精确约束参数和返回值，也可以只写Callable（不指定泛型参数），但会降低类型检查的精度。

2. 方法作为参数的类型提示 #

方法本质是绑定了实例/类的函数，类型提示逻辑和普通函数一致，仅需注意绑定状态的差异：

绑定后的实例方法 #

当实例方法绑定到对象后，self参数会被自动处理，类型提示只需标注剩余参数和返回值：

from collections.abc import Callable

class MyClass:
    def instance_method(self, x: str) -> str:
        return x + ' from instance'

def call_method(method: Callable[[str], str]) -> str:
    return method('hello')

obj = MyClass()
call_method(obj.instance_method)  # 类型检查正常

未绑定的实例方法/类方法 #

如果传入的是未绑定的实例方法（比如MyClass.instance_method），需要在类型提示中包含self的类型；类方法则需要包含cls的类型：

from collections.abc import Callable

class MyClass:
    def instance_method(self, x: str) -> str:
        return x + ' from instance'
    
    @classmethod
    def class_method(cls, x: str) -> str:
        return x + ' from class'

def call_unbound_instance_method(method: Callable[[MyClass, str], str]) -> str:
    obj = MyClass()
    return method(obj, 'hello')

def call_class_method(method: Callable[[type[MyClass], str], str]) -> str:
    return method(MyClass, 'hello')

call_unbound_instance_method(MyClass.instance_method)
call_class_method(MyClass.class_method)

静态方法的类型提示和普通函数完全一致，无需额外处理绑定参数。

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