在函数中返回不同类型的值时，请遵循以下规则：1. 在函数签名中指定返回类型；2. 使用异常处理不兼容类型；3. 避免返回 none 值；4. 确保返回类型与文档一致。通过这些规则，可以创建可维护且易于理解的代码。
函数返回不同类型值时的规则
在函数中返回不同类型的值是常见的做法，它可以为代码提供灵活性并增强其可重用性。但为了保持代码的可读性和可维护性，请遵循以下规则：
1. 在函数签名中明确指定返回类型：
通过在函数签名中使用类型注解，明确定义函数返回的值的预期类型。这有助于读者了解函数的预期行为，并避免在使用时出现意外情况。
def get_name() -> str:
"""
获取当前用户名。
:return: str
"""
# ...2. 使用异常来处理不兼容的类型：
如果函数返回意外类型的值（例如，当输入无效时），请使用异常来指示异常情况并提供清晰的信息。这将帮助用户在调试错误时快速解决问题。
def calculate_area(length: int, width: int) -> float:
"""
计算矩形的面积。
:param length: int - 矩形的长度
:param width: int - 矩形的宽度
:raise ValueError: 如果长度或宽度为非正整数
:return: float - 矩形的面积
"""
if length <= 0 or width <= 0:
raise ValueError("长度和宽度必须为正整数")
return length * width3. 避免返回 None 值：
在没有明确目的的情况下，尽量避免返回 None 值。如果要表示值不存在或无效，请考虑使用更具体的表示（例如，空列表或异常）。
# 不佳示例
def get_user_email() -> str:
"""
获取当前用户的电子邮件地址。
:return: str
"""
# ...
return None # 如果用户未登录则返回 None# 更佳示例
def get_user_email() -> Optional[str]:
"""
获取当前用户的电子邮件地址。
:return: str 或 None - 用户的电子邮件地址或 None（如果用户未登录）。
"""
# ...4. 确保返回类型与文档一致：
在函数文档中准确描述返回类型，并确保实际实现与之匹配。这将帮助用户了解函数的预期行为并避免混淆。
实战案例：
在以下 Python 代码中，我们定义了一个 get_user_info() 函数，它根据用户 ID 从数据库中获取用户信息。此函数可返回用户对象（如果用户存在）或 None（如果用户不存在）。
from typing import Optional
class User:
def __init__(self, name: str, email: str):
self.name = name
self.email = email
def get_user_info(user_id: int) -> Optional[User]:
"""
获取指定用户的信息。
:param user_id: int - 用户 ID
:return: User 或 None - 用户对象或 None（如果用户不存在）
"""
# 从数据库中获取用户信息
user_data = get_user_data_from_db(user_id)
if user_data:
return User(user_data["name"], user_data["email"])
else:
return None通过遵循这些规则，您可以在返回不同类型値时创建可维护且易于理解的代码。
