Python 返回值注解详解-CSDN博客

Python 的返回值注解是函数注解的一部分，用于指明函数返回值的类型。这种注解可以提高代码的可读性和可维护性，特别是在大型项目中。以下是关于 Python 返回值注解的详细说明：

1. 基本语法

在 Python 中，返回值注解使用 -> 符号，放置在函数参数列表之后，函数体之前。示例如下：

python复制

def add(a: int, b: int) -> int: return a + b

在这个例子中，-> int 表示函数 add 的返回值类型为 int。

2. 使用类型提示

基本类型：可以使用 Python 的内置类型，如 int, float, str, bool 等。
复杂类型：可以使用 List, Dict, Tuple 等来自 typing 模块的类型提示。

python复制

from typing import List, Dict def process_data(data: List[int]) -> Dict[str, int]: return {"sum": sum(data), "count": len(data)}

3. 可选返回值

如果函数可能返回 None，可以使用 Optional 类型提示：

python复制

from typing import Optional def find_item(items: List[str], target: str) -> Optional[int]: try: return items.index(target) except ValueError: return None

4. 自定义类型

可以使用 class 定义自定义类型，并在返回值注解中使用：

python复制

class User: def __init__(self, name: str, age: int): self.name = name self.age = age def get_user() -> User: return User("Alice", 30)

5. 结合 `Callable` 类型

如果函数返回另一个函数，可以使用 Callable 类型提示：

python复制

from typing import Callable def make_multiplier(factor: int) -> Callable[[int], int]: def multiplier(x: int) -> int: return x * factor return multiplier

6. 运行时不强制

需要注意的是，Python 的类型注解在运行时不强制执行，它们主要用于静态类型检查工具（如 mypy）和 IDE 的代码补全。

7. 使用 `Any` 类型

在某些情况下，您可能不确定函数的返回类型，或者返回类型可能是多种类型之一。在这种情况下，可以使用 Any 类型：

python复制

from typing import Any def get_value(key: str) -> Any: # This function could return any type of value return some_dict.get(key)

8. 使用 `Union` 类型

如果函数可能返回多种类型中的一种，可以使用 Union：

python复制

from typing import Union def parse_input(data: str) -> Union[int, float, str]: try: return int(data) except ValueError: try: return float(data) except ValueError: return data