Python类型提示（Type Hints）实战指南

第一程序员

2714人浏览 · 2026-04-14 21:28:54

第一程序员 · 2026-04-14 21:28:54 发布

Python类型提示（Type Hints）实战指南

作为一名从后端开发转向Rust的开发者，我发现Python的类型提示与Rust的类型系统有很多相似之处。类型提示可以提高代码的可读性和可维护性，特别是在大型项目中。今天我想分享一下我对Python类型提示的理解和实践。

什么是类型提示？

类型提示（Type Hints）是Python 3.5+引入的特性，它允许开发者为变量、函数参数和返回值添加类型注解。这些类型注解不会影响代码的运行，但可以被静态类型检查工具（如mypy）使用，帮助开发者在编译时发现类型错误。

基本语法

1. 变量类型提示

# 基本类型
name: str = "John"
age: int = 30
height: float = 1.75
is_active: bool = True

# 容器类型
from typing import List, Dict, Tuple

numbers: List[int] = [1, 2, 3, 4, 5]
user: Dict[str, str] = {"name": "John", "email": "john@example.com"}
point: Tuple[float, float] = (1.0, 2.0)

# 可选类型
from typing import Optional

optional_value: Optional[int] = None

2. 函数类型提示

from typing import List, Dict, Optional

def greet(name: str) -> str:
    return f"Hello, {name}!"

def add(a: int, b: int) -> int:
    return a + b

def get_user(id: int) -> Optional[Dict[str, str]]:
    users = {1: {"name": "John", "email": "john@example.com"}}
    return users.get(id)

def process_numbers(numbers: List[int]) -> List[int]:
    return [n * 2 for n in numbers]

高级类型提示

1. 泛型

from typing import TypeVar, List, Dict

T = TypeVar('T')

def first_element(items: List[T]) -> T:
    return items[0]

# 使用泛型
def process_dict_values(d: Dict[str, T]) -> List[T]:
    return list(d.values())

2. 联合类型

from typing import Union

def process_value(value: Union[int, str]) -> str:
    if isinstance(value, int):
        return f"Integer: {value}"
    else:
        return f"String: {value}"

3. 类型别名

from typing import List, Dict, Tuple, TypeAlias

# 使用TypeAlias（Python 3.10+）
User: TypeAlias = Dict[str, str]

# 旧版本使用赋值
UserTuple = Tuple[str, int, str]

def get_user_info(user: User) -> str:
    return f"Name: {user['name']}, Email: {user['email']}"

def process_user_tuple(user: UserTuple) -> Dict[str, str]:
    name, age, email = user
    return {"name": name, "age": age, "email": email}

4. 协议（Protocols）

from typing import Protocol

class Greeter(Protocol):
    def greet(self) -> str:
        ...

class Person:
    def greet(self) -> str:
        return "Hello!"

class Robot:
    def greet(self) -> str:
        return "Hello, human!"

def welcome(greeter: Greeter) -> str:
    return greeter.greet()

# 用法
person = Person()
robot = Robot()

print(welcome(person))  # 输出: Hello!
print(welcome(robot))   # 输出: Hello, human!

类型提示的最佳实践

从简单开始：先为核心函数和公共API添加类型提示，然后逐步扩展到整个代码库。
使用静态类型检查工具：安装并使用mypy来检查类型错误。
遵循PEP 484：按照官方的类型提示规范编写代码。
使用类型别名：为复杂的类型创建别名，提高代码的可读性。
合理使用Optional：对于可能为None的值，使用Optional类型。
避免过度使用Any：尽量避免使用Any类型，它会失去类型提示的意义。
使用Union处理多种类型：当一个变量可以是多种类型时，使用Union类型。
考虑使用Protocol：对于需要鸭子类型的场景，使用Protocol可以提供更好的类型安全性。

类型提示与Rust的对比

相似之处

都强调类型的重要性
都可以帮助开发者在编译时发现类型错误
都支持泛型和复杂的类型系统

不同之处

Python的类型提示是可选的，而Rust的类型系统是强制性的
Python的类型提示不会影响运行时行为，而Rust的类型系统会影响编译和运行
Python的类型提示语法相对简单，而Rust的类型系统更加复杂和强大

实战案例：使用类型提示构建一个简单的用户管理系统

from typing import List, Dict, Optional, TypeAlias

User: TypeAlias = Dict[str, str | int]

class UserManager:
    def __init__(self):
        self.users: List[User] = []
    
    def add_user(self, name: str, email: str, age: int) -> User:
        user = {"name": name, "email": email, "age": age}
        self.users.append(user)
        return user
    
    def get_user_by_name(self, name: str) -> Optional[User]:
        for user in self.users:
            if user["name"] == name:
                return user
        return None
    
    def get_all_users(self) -> List[User]:
        return self.users
    
    def update_user(self, name: str, email: Optional[str] = None, age: Optional[int] = None) -> Optional[User]:
        user = self.get_user_by_name(name)
        if user:
            if email is not None:
                user["email"] = email
            if age is not None:
                user["age"] = age
            return user
        return None

# 使用示例
if __name__ == "__main__":
    manager = UserManager()
    
    # 添加用户
    manager.add_user("John", "john@example.com", 30)
    manager.add_user("Jane", "jane@example.com", 25)
    
    # 获取所有用户
    print("All users:")
    for user in manager.get_all_users():
        print(user)
    
    # 根据姓名获取用户
    print("\nUser named John:")
    print(manager.get_user_by_name("John"))
    
    # 更新用户
    print("\nUpdating John's email:")
    updated_user = manager.update_user("John", email="john.doe@example.com")
    print(updated_user)
    
    # 获取所有用户
    print("\nAll users after update:")
    for user in manager.get_all_users():
        print(user)