Python函数注解怎么写_类型提示实战解析【教程】

Python函数注解是为开发者和工具提供类型信息的语法，不改变运行行为；基础写法为参数后加冒号类型、函数后加箭头返回类型；支持Optional、联合类型、泛型容器、自定义别名与TypedDict；建议新函数优先添加、API函数必须完整标注，并配合mypy和IDE进行静态检查。

Python函数注解（即类型提示）不是装饰器，也不是运行时强制检查的语法，而是为开发者和工具（如IDE、mypy、pyright）提供可读、可校验的类型信息。写得清楚，能显著提升代码可维护性、减少参数误用，还能让自动补全更准。

基础语法：用 -> 和 : 标注返回值与参数

在函数定义中，参数名后加冒号 + 类型，函数括号后加箭头 + 返回类型：

def greet(name: str, age: int) -> str:
    return f"Hello {name}, you are {age} years old"

• name: str 表示 name 参数应为字符串
• age: int 表示 age 应为整数
• -> str 表示函数返回值预期是字符串
• 类型提示不改变运行行为——Python仍会照常执行，哪怕传入 float 或 None

常用内置类型与组合写法

除了 int、str、bool、float 等基础类型，还需掌握这些高频写法：

标签： python 工具 vs code python函数