Python 类型提示模块 typing 详解

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

文章目录

• • 1. 什么是 `typing`？
  • 2. 基础用法
  • • （1）变量类型标注
    • （2）函数类型标注
    • （3）可选类型（`Optional`）
    • （4）联合类型（`Union`）
    • （5）任意类型（`Any`）
  • 3. 常用类型总结
  • 4. 高级用法（简单提一下）
  • 5. 学生成绩管理系统 Demo（含 typing 标注）

1. 什么是 typing？

typing 是 Python 的 类型提示（type hints）库，它不改变 Python 本身的动态特性，但能让我们：

• 给变量、函数、类加上类型标注，提高代码可读性；
• 帮助 IDE 和工具做静态检查，提前发现 bug；
• 方便团队协作，别人一眼就能看懂你函数需要什么类型、返回什么。

📌 注意：类型提示 不会影响代码运行，只是“标注”，主要用来提示和检查。

2. 基础用法

（1）变量类型标注

from typing import List, Dict

name: str = "Alice"
age: int = 18
scores: List[int] = [95, 88, 76]
info: Dict[str, int] = {"math": 95, "english": 88}

• name: str → 表示 name 是字符串
• age: int → 表示 age 是整数
• scores: List[int] → 表示 scores 是整数列表
• info: Dict[str, int] → 表示 info 是 key 为字符串，value 为整数的字典

（2）函数类型标注

from typing import List

def add(x: int, y: int) –> int:
return x + y

def average(nums: List[int]) –> float:
return sum(nums) / len(nums)

• 参数和返回值都可以标注
• -> int 表示返回值类型是整数
• -> float 表示返回值类型是浮点数

（3）可选类型（Optional）

有时候参数可以是某种类型，也可以是 None：

from typing import Optional

def greet(name: Optional[str]) –> str:
if name:
return f"Hello, {name}"
return "Hello, stranger"

这里 Optional[str] 等价于 Union[str, None]。

（4）联合类型（Union）

表示一个值可以是几种类型：

from typing import Union

def square(x: Union[int, float]) –> float:
return x * x

x 可以是 int 或 float。

（5）任意类型（Any）

如果你不确定类型，可以用 Any：

from typing import Any

def process(data: Any) –> None:
print("接收到:", data)

👉 Any 就是“啥都行”。

3. 常用类型总结

示例：

from typing import Tuple, Set, Callable

def get_point() –> Tuple[int, int]:
return (3, 5)

def unique_names() –> Set[str]:
return {"Alice", "Bob"}

def operate(func: Callable[[int, int], int], x: int, y: int) –> int:
return func(x, y)

4. 高级用法（简单提一下）

• TypedDict：可以给字典定义固定结构
• Literal：限制值只能是几个固定的常量
• Protocol：接口风格的类型检查（鸭子类型）

这些在大型项目中更常用，新手可以先跳过。

5. 学生成绩管理系统 Demo（含 typing 标注）

from typing import List, Dict, Optional, Tuple

# 学生成绩类型：课程 -> 分数
Scores = Dict[str, float]

# 学生类型
class Student:
def __init__(self, name: str, age: int, scores: Optional[Scores] = None) –> None:
self.name: str = name
self.age: int = age
self.scores: Scores = scores or {}

def add_score(self, subject: str, score: float) –> None:
"""添加或更新成绩"""
self.scores[subject] = score

def get_average(self) –> Optional[float]:
"""计算平均分"""
if not self.scores:
return None
return sum(self.scores.values()) / len(self.scores)

def __repr__(self) –> str:
return f"Student(name={self.name}, age={self.age}, scores={self.scores})"

# 成绩管理系统
class GradeSystem:
def __init__(self) –> None:
self.students: List[Student] = []

def add_student(self, student: Student) –> None:
"""添加学生"""
self.students.append(student)

def find_student(self, name: str) –> Optional[Student]:
"""按名字查找学生"""
for s in self.students:
if s.name == name:
return s
return None

def get_top_student(self) –> Optional[Tuple[str, float]]:
"""获取平均分最高的学生 (名字, 平均分)"""
if not self.students:
return None
top = max(
self.students,
key=lambda s: s.get_average() or 0.0
)
return (top.name, top.get_average() or 0.0)

# 使用示例
if __name__ == "__main__":
# 初始化系统
system = GradeSystem()

# 添加学生
alice = Student("Alice", 18)
bob = Student("Bob", 19)

system.add_student(alice)
system.add_student(bob)

# 添加成绩
alice.add_score("math", 95)
alice.add_score("english", 88)

bob.add_score("math", 76)
bob.add_score("english", 82)
bob.add_score("physics", 90)

# 查询学生
stu = system.find_student("Alice")
print("找到学生:", stu)

# 平均分
print("Alice 平均分:", stu.get_average() if stu else None)

# 最强学霸
top = system.get_top_student()
print("学霸是:", top)

📝 运行结果（示例）

找到学生: Student(name=Alice, age=18, scores={'math': 95, 'english': 88})
Alice 平均分: 91.5
学霸是: ('Bob', 82.66666666666667)

💡 这里的 typing 用法

🚀 感谢阅读！想了解更多？

📖 我的博客网站 | 记录思考，分享干货 🏡 我的个人主页 | 关于我、开源项目