Python函数应区分正常结果与异常：错误须抛出具体异常而非返回None等哑值；预期空值用Optional[T]或Result类；避免元组返回引发解包错误。
Python函数返回设计的核心在于明确区分“正常结果”与“异常情况”，避免用返回值掩盖错误，也别让调用方猜函数到底成功没。
别用None或特殊值表示失败
常见误区是让函数在出错时返回None、-1、空字符串等“哑值”，再让调用方手动检查。这容易漏判、逻辑分散，还破坏类型一致性。
- 比如parse_json(s)返回None代表解析失败，但None也可能是合法JSON内容（如null）
- 又如find_user(id)返回None，调用方得写if user is not None:，一旦忘了就崩
该抛异常时就抛，别吞掉
输入非法、资源不可用、协议不匹配等属于真正异常，应由函数主动抛出具体异常（如ValueError、FileNotFoundError），而不是静默返回默认值。
- 异常能中断错误流程，强制调用方处理；堆栈信息也便于定位问题源头
- 用raise ValueError("age must be positive")比返回-1更清晰、更安全
- 若需封装底层异常，可用raise MyCustomError(...) from e保留原始上下文
需要“可选结果”时，用显式结构表达
当函数天然可能无结果（如查数据库没命中、配置项未设置），且这不是错误，推荐返回Optional[T]（类型提示）+ 显式判断，或用Result类（第三方如returns库）。
立即学习“Python免费学习笔记（深入）”；
- 标准写法：def get_config(key) -> str | None:，调用方明确写if val := get_config("host"):
- 进阶写法：自定义class Result[Ok, Err]:，带is_success()、unwrap()等方法，语义更重
- 避免把“找不到”和“找错了”混为一谈——前者是预期分支，后者才是异常
返回元组？小心解包失败
用(data, error)双返回值看似直观，但容易引发静默错误：调用方可能只取第一个值，忽略第二个；或顺序记错导致逻辑颠倒。
- 如果坚持用元组，务必加类型注解：def connect() -> tuple[str, Exception | None]:
- 更推荐用dataclass或NamedTuple命名字段，比如ConnectResult(ok: bool, msg: str, data: bytes = b"")
- 永远不要返回(None, "not found")却期望别人记住第二个是错误信息
