下面是详细讲解“Python Type Hints 学习之从入门到实践”的完整攻略：

Python Type Hints 学习之从入门到实践

什么是 Python Type Hints

Python 从 3.5 版本开始引入了 Type Hints 的概念，它是一种用于标注函数、变量、类等对象类型的注释。Python 并不会在运行时对其进行强制校验，但是可以让我们在编码的时候更加清楚地了解自己程序的类型信息，提高程序的可读性、可维护性和稳定性。

如何使用 Python Type Hints

Python Type Hints 用法非常简单，只需要在代码块前加入对应的注释即可。下面是一些 Python Type Hints 的示例：

def my_func(num: int, name: str = "Python"):
    """
    这是一个带有 Python Type Hints 注释的函数
    """
    print("Hello, {name}! Your number is {num}".format(name=name, num=num))

上面的代码示例中，my_func 函数接收两种类型的参数：整数类型的 num 和字符串类型的 name，其中 name 的默认值为 "Python"。通过注释中的类型信息，我们可以很清楚地知道这个函数需要传入什么类型的参数。

除了函数之外，Python Type Hints 还可以使用在变量、列表、字典、元组以及类等对象中：

greeting: str = "Hello, World!"  # 字符串类型的变量

num_list: List[int] = [1, 2, 3, 4, 5]  # 整数类型的列表

person_dict: Dict[str, str] = {"name": "John", "age": "28"}  # 字符串类型的键和值都为字符串类型的字典

coordinate: Tuple[int, int] = (3, 5)  # 包含两个整数类型元素的元组

class Person:
    def __init__(self, name: str, age: int) -> None:
        self.name = name
        self.age = age

Python Type Hints 常见用法

函数注释

函数中使用 Python Type Hints 很常见，这样可以对函数的参数和返回值有一个明确的类型定义，增加代码的可读性和可维护性。

def add(x: int, y: int) -> int:
    # 返回值类型注释，意为该函数返回一个整型
    return x + y

变量注释

Python Type Hints 中也可以使用于变量中，这样可以让开发者在不破坏调用方数据时能准确的提示数据类型，同时更容易理解这个变量的作用。

age: int = 30

Tuple & List

当处理一些列表或元组类型的数据时，可以使用 Python Type Hints 来注释每个元素的类型。

nums: List[int] = [1, 2, 3, 4]
coordinates: Tuple[int, int] = (3, 5)

Dict

当使用字典类型的数据时，可以使用 Python Type Hints 来注释 key 及 value 的类型。

person: Dict[str, Union[str, int]] = {
    "name": "Dylan",
    "age": 25,
    "hobbies": ["music", "sports"]
}

Union

Union 用于注释同一个变量可以使用的不同数据类型。

def get_items(n: Union[str, int]) -> Union[str, int]:
    if isinstance(n, str):
        return n.split(",")
    elif isinstance(n, int):
        return n

以上就是 Python Type Hints 学习之从入门到实践的完整攻略。这里提供两个 Python Type Hints 的示例，供读者参考。

示例1：注释函数参数与返回值类型

def divide(x: float, y: float) -> float:
    # 函数注释，意为该函数接收两个浮点型参数，返回一个浮点型值
    return x / y

在上面的代码中，divide 函数注释明确说明了该函数接收两个浮点型参数，并返回一个浮点型值。

示例2：注释类中属性的类型

class Person:
    def __init__(self, name: str, age: int) -> None:
        # 类属性注释，意为该属性是字符串类型
        self.name: str = name

        # 类属性注释，意为该属性是整数类型
        self.age: int = age

    def birthday(self) -> None:
        # 函数注释，意为该函数没有返回值
        self.age += 1

在上面的代码中，我们使用 Python Type Hints 注释了 Person 类中的两个属性 name 和 age，以及 birthday 函数没有返回值。这样可以让开发者更清楚地知道每个属性的类型，并确保代码的可读性。