用途:这是一份 Python 反模式参考清单,用于代码合并前审查、排查疑难问题、学习最佳实践、建立团队规范以及重构旧代码。它以“应避免什么”为核心,正面模式与架构建议另有专门技能覆盖。
主要能力:清单按类别整理了典型错误及其修复方向。基础设施层面包括超时/重试逻辑分散、应用与客户端双重重试、配置与密钥硬编码;架构层面包括暴露 ORM 等内部类型、I/O 与业务逻辑混杂;错误处理层面包括裸 except 吞异常、批量处理遇错即停、缺少输入校验;资源层面包括资源未关闭、异步中阻塞调用;类型与测试层面包括缺少类型提示、集合无类型参数、只测正常路径、过度 Mock。
使用方式:在代码定稿或合并前逐项核对,例如检查重试是否集中、配置是否来自环境变量、异常是否按具体类型捕获、资源是否用上下文管理器、异步是否使用原生异步库、公开函数是否标注类型、错误路径与边界是否被测试。修复方向以集中式装饰器、环境变量加 pydantic-settings、DTO/响应模型、Repository 模式、BatchResult 汇总成功与失败、Pydantic 边界校验、异步原生库、类型注解为主。
限制:本技能只提供反模式清单,不涉及正面设计模式与架构指导;具体平台、收费、效果等信息暂未提供。另有可变默认参数共享状态、裸 except 吞掉 Ctrl+C、slots 影响 pickle/弱引用/多继承、is 与 == 对小整数与驻留字符串的差异、assert 在 -O 下被剥离等注意事项,均属运行时陷阱,需结合实际情况判断。