可调用对象的联合和可调用对象列表转换为可调用对象列表时出现Python mypy类型错误

在Python中，mypy是一个静态类型检查器，它可以帮助开发者在编译时发现类型错误。当你尝试将可调用对象的联合（例如Union[Callable[..., Any], List[Callable[..., Any]]]）转换为可调用对象列表（例如List[Callable[..., Any]]）时，可能会遇到类型错误。这是因为mypy无法保证联合类型中的每个元素都满足目标类型的约束。

基础概念

可调用对象：在Python中，任何可以调用的对象都是可调用对象，包括函数、方法、类以及实现了__call__方法的实例。
类型联合：表示一个值可以是多种类型之一。在Python的类型提示中，使用Union来表示。
类型列表：表示一个列表中的所有元素都是同一类型。在Python的类型提示中，使用List[T]来表示，其中T是元素的类型。

类型错误的原因

当你有一个可能是单个可调用对象或可调用对象列表的变量时，mypy无法保证在转换过程中每个元素都是可调用对象。例如：

from typing import Callable, List, Union

def example() -> None:
    pass

def process_callables(callables: Union[Callable[..., Any], List[Callable[..., Any]]]) -> None:
    callables_list: List[Callable[..., Any]] = callables  # mypy错误
    for callable in callables_list:
        callable()

在这个例子中，mypy会报错，因为它不能保证callables在转换为列表时，每个元素都是可调用对象。

解决方法

为了解决这个问题，你需要确保在转换之前，所有的元素都是可调用对象。可以通过类型检查和转换来实现：

from typing import Callable, List, Union, cast

def example() -> None:
    pass

def process_callables(callables: Union[Callable[..., Any], List[Callable[..., Any]]]) -> None:
    if isinstance(callables, list):
        callables_list = callables
    else:
        callables_list = [callables]
    for callable in callables_list:
        callable()

# 或者使用类型断言
def process_callables_with_cast(callables: Union[Callable[..., Any], List[Callable[..., Any]]]) -> None:
    callables_list: List[Callable[..., Any]] = cast(List[Callable[..., Any]], callables)
    for callable in callables_list:
        callable()

在这个修正后的代码中，我们首先检查callables是否为列表，如果不是，则将其包装在一个列表中。这样，mypy就可以确认所有的元素都是可调用对象，从而避免了类型错误。