Python Type Hint有啥用

Python 的类型提示（Type Hint）是 Python 3.5 引入的一种静态类型检查功能。类型提示的主要目的是增强代码的可读性、可维护性和错误检测能力。虽然 Python 仍然是动态类型的语言，但类型提示可以帮助开发者在编码和维护过程中受益匪浅。

类型提示的好处

1. 提高代码可读性：类型提示可以使代码的意图更加清晰，其他开发者（包括未来的你自己）可以更容易理解代码的用途和设计。
2. 增强错误检测能力：使用类型提示，借助静态类型检查工具（如 MyPy），可以在代码运行前检测到潜在的类型错误，减少运行时错误。
3. 改进 IDE 支持：现代 IDE（如 PyCharm、VSCode）会利用类型提示提供更好的代码补全、导航和重构支持。
4. 自文档化：类型提示使函数签名本身成为一种文档，省去了部分注释的需求。

类型提示的基本语法

函数参数和返回值

可以为函数的参数和返回值添加类型提示：

def greet(name: str) -> str:
    return f"Hello, {name}!"

# 调用示例
greet("Alice")  # "Hello, Alice!"

变量

Python 3.6 引入了变量的类型注释语法：

age: int = 25
name: str = "Alice"
is_student: bool = True

复杂类型

可以使用 typing 模块中的类型来表示复杂类型，如列表、字典、元组等：

from typing import List, Dict, Tuple, Union, Optional

# 列表
numbers: List[int] = [1, 2, 3, 4, 5]

# 字典
name_age: Dict[str, int] = {"Alice": 25, "Bob": 30}

# 元组
point: Tuple[int, int] = (10, 20)

# 多种类型（联合类型）
data: Union[int, str] = 42

# 可选类型（可以为 None）
optional_value: Optional[int] = None

自定义类型

可以使用 typing 模块中的 Type 创建自定义类型：

from typing import Type

class Animal:
    pass

class Dog(Animal):
    pass

def create_animal(cls: Type[Animal]) -> Animal:
    return cls()

# 调用示例
dog = create_animal(Dog)

使用静态类型检查工具

MyPy 是一个常用的静态类型检查工具，它可以帮助检测代码中的类型错误。在项目中使用 MyPy，可以通过命令行运行：

mypy your_script.py

示例

下面是一个包含类型提示的示例函数，用于处理学生成绩：

from typing import List, Dict, Optional

def average_grade(grades: List[Dict[str, Optional[float]]]) -> float:
    total = 0.0
    count = 0
    for grade in grades:
        if grade["grade"] is not None:
            total += grade["grade"]
            count += 1
    return total / count if count > 0 else 0.0

# 调用示例
student_grades = [
    {"name": "Alice", "grade": 85.0},
    {"name": "Bob", "grade": None},
    {"name": "Charlie", "grade": 95.0}
]

print(average_grade(student_grades))  # 90.0

结论

说实话，这个玩意复杂的情景不太会用，谁能告诉我，你们是不是一直在用？