返回类型不确定时应使用何种Python类型提示？

当函数返回类型不确定时，确实有对应的类型提示方式，常用的有两种方案：

1. 使用Any类型 #

如果完全无法确定返回值的类型，直接用Any是最直接的选择，它表示任意类型，类型检查器会对该类型的变量放宽校验。

示例代码：

from typing import Any
import pickle

def open_pkl(src: str) -> Any:
    # 注意：原代码中固定打开'serialized.pkl'，建议改为使用参数src，让函数更通用
    with open(src, 'rb') as f:
        data = pickle.load(f)
    return data

2. 使用泛型TypeVar实现灵活类型标注 #

如果调用者通常知道自己序列化的对象类型，可以用TypeVar定义泛型，让调用者在使用时指定预期的返回类型，兼顾灵活性和类型检查。

方式一：调用时通过类型注解指定 #

from typing import TypeVar
import pickle

T = TypeVar('T')

def open_pkl(src: str) -> T:
    with open(src, 'rb') as f:
        data = pickle.load(f)
    return data

# 调用时标注预期类型，类型检查器会基于此做校验
my_user: User = open_pkl("user_data.pkl")
my_dict: dict[str, float] = open_pkl("stats.pkl")

方式二：传入类型参数做运行时校验 #

如果需要在运行时确保返回值类型符合预期，可以增加类型参数并做校验：

from typing import TypeVar, Type
import pickle

T = TypeVar('T')

def open_pkl(src: str, expected_type: Type[T]) -> T:
    with open(src, 'rb') as f:
        data = pickle.load(f)
    if isinstance(data, expected_type):
        return data
    raise TypeError(f"加载的数据类型不符，预期{expected_type.__name__}，实际{type(data).__name__}")

# 调用示例
my_list = open_pkl("list_data.pkl", list)

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