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

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

冰川箭仙

发布： 2025-12-23 22:36:11

原创

565人浏览过

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

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

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 等基础类型，还需掌握这些高频写法：

Blogcast™

BlogcastTM是一个文本转语音的工具，允许用户创建播客、视频、电子学习课程的音频和音频书籍，而无需录制。

查看详情

可选值：用 Optional[str] 或简写 str | None（Python 3.10+）
联合类型：如 int | str 表示“可以是整数或字符串”
列表/字典：用 list[int]、dict[str, float]（注意大小写，需从 typing 导入或使用内置泛型，Python 3.9+ 支持内置）
可变参数：*args: tuple[int, ...] 表示任意多个整数；**kwargs: dict[str, Any] 需导入 Any

自定义类型与别名，让提示更语义化

避免重复写冗长类型，也便于统一修改：

立即学习“Python免费学习笔记（深入）”；

from typing import Dict, List, TypedDict

UserId = int
UserName = str
UserRecord = Dict[UserId, UserName]

class User(TypedDict):
    id: int
    name: str
    active: bool

def get_users() -> List[User]:
    ...

登录后复制