### Python 中常见注解类型及用途 #### 类型注解概述 Python 提供了一种机制来为函数参数和返回值添加类型提示，这被称为 **类型注解** 或者 **类型提示 (Type Hints)**。尽管这些注解并不影响程序运行时的行为[^1]，它们对于提高代码的可读性和维护性具有重要意义。 #### 基本类型注解 最简单的类型注解是对函数参数和返回值进行基本类型的声明。例如： ```python def greet(name: str) -> str: return f"Hello, {name}" ``` 上述例子中，`str` 是 `name` 参数的类型注解，表示该参数应为字符串；`-> str` 则表明此函数会返回一个字符串[^3]。 #### 联合类型（Union） 当某个变量可能有多种不同的类型时，可以使用 `Union` 来定义联合类型。这意味着这个变量可以接受其中任何一种类型作为其值。 ```python from typing import Union def process(value: Union[int, float]) -> Union[int, float]: return value * 2 ``` 在这个例子中，`value` 可以是一个整数或者浮点数，并且函数也会相应地返回这两种类型之一[^2]。 #### 可选类型（Optional） 如果希望表达某参数可能是特定类型也可能是 None，则可以利用 `Optional[T]`，它实际上是 `Union[T, None]` 的简写形式。 ```python from typing import Optional def find_user(id: int) -> Optional[str]: user = database.get(id) return user.name if user is not None else None ``` 这里说明了查找用户操作可能会成功找到用户的名称 (`str`) 或失败并返回 `None`。 #### 集合类别的类型注解 针对集合类别如列表、字典等复杂结构的数据类型也可以通过导入相应的泛型容器来进行精确描述。 ```python from typing import List, Dict def get_top_scores(scores: List[float]) -> Dict[str, float]: top_score = max(scores) average = sum(scores)/len(scores) return {"top": top_score, "average": average} ``` 这段代码展示了如何对输入参数应用列表类型注解以及输出结果采用字典型号注解的方式。 #### 自定义对象类型注解 除了内置的基础数据类型外，还可以对自己创建的对象实例设定具体的要求。 ```python class Point: def __init__(self, x: float, y: float): self.x = x self.y = y def distance(p1: Point, p2: Point) -> float: dx = p1.x - p2.x dy = p1.y - p2.y return (dx*dx + dy*dy) ** 0.5 ``` 此处明确了两个位置之间的距离计算方法仅适用于自定义 `Point` 对象之间交互的情况。 ### 总结 以上介绍了几种常用的 Python 注解方式及其实际应用场景，包括但不限于基础类型、联合类型、可选项以及其他高级特性。合理运用这些工具能够显著提升大型项目开发过程中的效率与质量。