用途:该技能提供 Python 错误处理的实践模式,帮助构建输入校验、异常层级与优雅失败处理的健壮应用,便于调试并提升系统可靠性。适用场景包括校验用户输入与 API 参数、设计应用异常层级、处理批量操作中的部分失败、将外部数据转换为领域类型、构建友好的错误信息以及实现快速失败校验。
主要能力与模式:1)快速失败,在昂贵操作前尽早校验输入,尽量一次性报告全部校验错误;2)有意义的异常,使用合适异常类型并附上下文,说明失败原因与修复方式;3)部分失败处理,批量操作中不让单个失败中断全部,分别记录成功与失败;4)保留上下文,通过异常链维护完整错误轨迹。具体模式包括:早期输入校验、在系统边界将字符串解析为枚举等类型、用 Pydantic 做复杂校验、将错误映射到标准异常(ValueError、TypeError、KeyError、RuntimeError、TimeoutError、FileNotFoundError、PermissionError)、自定义带结构化信息的异常、异常链、批量部分失败与进度回调。
使用方式:在 API 边界先校验必填项与取值范围,再进入处理逻辑;用 try/except 捕获并转换异常,用 raise ... from e 保留原因;批量处理时逐项捕获异常并汇总结果。
限制与注意:raise X from None 会抑制原因链,裸 raise 才保留原位置;assert 会被 python -O 剥离,运行时校验必须用 if + raise;异常组(3.11+)需用 except*;finally 中的 return 会覆盖返回值并吞掉异常。资料未提供安装命令、收费或平台信息。