为什么需要类型注解

看下图，很精炼；

什么是类型注解

Python类型注释是指在变量、函数参数、返回值等位置添加类型信息的一种语法，其目的是提高代码的可读性和可维护性。

具体来说，在变量名后面使用冒号加上类型可以声明变量的类型，如下所示：

# 声明变量a的类型为int
a: int = 10
num: int = 10
name: str = "zhangsan"

其实对于基本类型你无需注解，呢都是字面量一眼就看出来了，注解一般使用在方法中欧，或者一眼无法看出的数据变量添加注解；

在函数参数和返回值中也可以使用类型注释，如下所示：

语法格式：

 def 函数名（形参：类型，。。。。）—> 返回值类型：
     函数主体

案例：

def greet(name: str) -> str:
    return "Hello, " + name

在上面的代码中，greet函数接受一个字符串参数并返回一个字符串，这些类型信息都通过类型注释进行了说明。

类型注释不会影响Python程序的执行，但可以被静态类型检查工具和IDE等工具使用，以检测代码中的类型错误和提供代码提示。例如，可以使用mypy等工具对Python代码进行静态类型检查。

需要注意的是，Python类型注释是可选的，并不强制要求使用。同时，Python解释器也不会对类型注释进行任何验证或检查。因此，即使没有添加类型注释，Python仍然可以正常运行。

总之，Python类型注释提供了一种简单、可选的方法来说明代码中变量、函数参数和返回值的类型信息，有助于提高代码的可读性和可维护性。

联合注解

Python联合注释（Union Annotation）是指在类型注释中使用typing.Union来表示一个变量可以有多种类型之一。例如，如果一个函数的参数可以是字符串或整数，则可以使用联合注释来表示这个参数的类型。

以下是一个使用联合注释的简单示例：

from typing import Union

def add(a: Union[int, float], b: Union[int, float]) -> Union[int, float]:
    return a + b

在上面的代码中，add函数接受两个参数a和b，它们的类型可以是int或float中的任意一种。同时，add函数返回值的类型也可以是int或float中的任意一种。

需要注意的是，在使用联合注释时应当尽可能地避免使用太多的类型，否则可能会降低代码的可读性。通常情况下，只有在一个变量明确具有多种类型时才应该使用联合注释。

总之，Python联合注释提供了一种灵活的方式来表示一个变量可以具有多种类型之一，有助于提高代码的可读性和可维护性。

使用注解时的注意点

在使用Python注解时，需要注意以下几点：

注解不会影响程序的运行。Python解释器会忽略所有的注解，因此即使没有添加注解，代码仍然可以正常运行。

注解是可选的。虽然注解可以提高代码的可读性和可维护性，但并不强制要求使用。如果一个开发团队不喜欢使用注解，也可以完全不使用。

注解只对IDE和静态类型检查工具有用。注解中包含的信息可以被IDE和静态类型检查工具用来提供代码提示和检查类型错误，但对于Python解释器本身来说没有任何作用。

注解应该尽量简洁明了。过多或复杂的注解可能会降低代码的可读性和可维护性，应该尽量避免这种情况的发生。

注解应该尽量准确。如果注解不准确，则可能导致IDE和静态类型检查工具给出错误的代码提示，甚至会导致程序运行时出现类型错误。