Python 的类型标注（Type Hints）是 PEP 484 引入的特性，不会改变 Python 动态类型的本质（解释器不会强制校验类型），但能让代码更易理解、IDE（如 PyCharm、VS Code）提供智能提示，还能通过静态检查工具（如 mypy）提前发现类型错误。
一、基础类型标注
1.1 简单变量标注
对于整数、字符串、浮点数、布尔值等基础类型，直接在变量名后加:+ 类型即可。
python
# 基础类型标注示例 age: int = 25 # 整数类型 name: str = "张三" # 字符串类型 height: float = 1.75 # 浮点数类型 is_student: bool = True # 布尔类型1.2 延迟赋值的变量标注
如果变量先声明、后赋值（比如在函数开头声明），可以单独标注类型：
python
# 延迟赋值的标注 total: int total = 0 # 后续赋值 # 空值标注（None类型） empty_var: None = None二、复杂数据类型标注
对于列表、字典、元组等复杂类型，Python 3.9+ 支持直接用内置类型标注（更简洁），3.9 以下需要从typing模块导入对应类型。
2.1 列表（List）
标注列表中元素的具体类型：
python
# Python 3.9+ 写法（推荐） nums: list[int] = [1, 2, 3] # 元素为整数的列表 names: list[str] = ["张三", "李四"] # 元素为字符串的列表 # Python 3.8及以下写法（需导入typing） from typing import List nums: List[int] = [1, 2, 3]2.2 字典（Dict）
标注字典的键和值的类型：
python
# Python 3.9+ 写法 user_info: dict[str, str] = {"name": "张三", "city": "北京"} # 键值均为字符串 score: dict[str, int] = {"math": 90, "english": 85} # 键为字符串，值为整数 # Python 3.8及以下写法 from typing import Dict user_info: Dict[str, str] = {"name": "张三", "city": "北京"}2.3 元组（Tuple）
元组标注需要指定每个元素的类型（固定长度），或指定统一类型 +...（任意长度）：
python
# Python 3.9+ 写法 # 固定长度+固定类型（比如坐标：x,y都是浮点数） point: tuple[float, float] = (10.5, 20.8) # 任意长度+统一类型（所有元素都是整数） numbers: tuple[int, ...] = (1, 2, 3, 4) # Python 3.8及以下写法 from typing import Tuple point: Tuple[float, float] = (10.5, 20.8)2.4 可选类型（Optional）
标注变量可以是指定类型，也可以是None：
python
# Python 3.10+ 写法（更简洁） email: str | None = None # 可以是字符串或None # Python 3.9及以下写法 from typing import Optional email: Optional[str] = None # 等价于 Union[str, None]2.5 任意类型（Any）
如果不确定变量类型，可用Any（不推荐过度使用，会失去类型标注的意义）：
python
from typing import Any data: Any = 123 data = "hello" # 类型可以随意改变 data = [1, 2, 3]三、函数的参数和返回值标注
类型标注最常用的场景是函数，包括参数类型和返回值类型（返回值用->标注）。
3.1 基础函数标注
python
# 计算两数之和的函数 def add(a: int, b: int) -> int: return a + b # 调用函数（IDE会提示参数类型，mypy会校验类型） result = add(5, 3) # 正确 # result = add(5, "3") # mypy会提示类型错误（字符串不能传给int参数）3.2 带默认参数的函数标注
默认参数的标注写在=前面：
python
def greet(name: str, age: int = 18) -> str: return f"你好，{name}，今年{age}岁" print(greet("张三")) # 输出：你好，张三，今年18岁 print(greet("李四", 20)) # 输出：你好，李四，今年20岁3.3 返回值为 None 的函数
如果函数没有返回值（或返回 None），返回值标注为None：
python
def print_info(name: str) -> None: print(f"姓名：{name}") print_info("张三") # 无返回值，标注为None3.4 进阶：函数类型（Callable）
标注 “函数类型” 的变量（比如回调函数）：
python
from typing import Callable # 定义一个接收int参数、返回str的函数类型 callback: Callable[[int], str] = lambda x: f"数字是：{x}" # 使用这个函数类型 def process_data(num: int, func: Callable[[int], str]) -> str: return func(num) print(process_data(10, callback)) # 输出：数字是：10四、自定义类型别名
如果复杂类型需要重复使用，可以用TypeAlias定义别名，简化代码：
python
from typing import TypeAlias, List # 定义类型别名 StudentScores: TypeAlias = List[dict[str, str | int]] # 学生成绩类型：列表里的每个元素是字典 # 使用别名 math_scores: StudentScores = [ {"name": "张三", "score": 95}, {"name": "李四", "score": 88} ]五、类型标注的验证工具
类型标注本身不影响代码运行，但可以用mypy工具静态检查类型错误：
5.1 安装 mypy
bash
pip install mypy5.2 检查代码
假设你有一个test.py文件：
python
def add(a: int, b: int) -> int: return a + b # 故意传错类型 result = add(5, "3") print(result)运行检查命令：
bash
mypy test.pymypy 会输出类型错误提示：
plaintext
test.py:5: error: Argument 2 to "add" has incompatible type "str"; expected "int" Found 1 error in 1 file (checked 1 source file)总结
关键点回顾
- 核心作用：类型标注（Type Hints）用于显式声明变量 / 函数的类型，提升代码可读性和可维护性，支持 IDE 提示和静态检查（mypy），但不改变 Python 动态类型的本质。
- 版本兼容：Python 3.9+ 可直接用
list[int]/dict[str, int]等内置类型标注；3.9 以下需从typing模块导入List/Dict。 - 常用场景：函数参数 / 返回值标注是最核心的使用场景，复杂类型可通过别名简化，可选类型用
str | None（3.10+）或Optional[str]。
通过类型标注，你可以让自己的 Python 代码更规范，尤其是在团队协作或大型项目中，能大幅降低类型相关的 bug 概率。
