用途:这是一个 Python 反模式(anti-patterns)参考清单,用于在代码合并前评审、排查疑难问题、教学或学习 Python 最佳实践、建立团队编码规范以及重构遗留代码时逐项对照,帮助尽早发现问题。它聚焦“应避免什么”,正向模式与架构可参考 python-design-patterns 技能。
主要能力:按类别列出常见反模式并给出修复方向。基础设施类:超时/重试逻辑分散(应集中到装饰器或客户端封装)、多层重复重试(应只在一层重试)、硬编码配置与密钥(应使用环境变量配合 pydantic-settings 等类型化设置)。架构类:暴露内部类型如 ORM 模型(应使用 DTO/响应模型)、I/O 与业务逻辑混杂(应使用仓储模式保持业务逻辑纯粹)。错误处理类:裸 except Exception 静默吞异常(应捕获具体异常并记录或处理)、批量处理忽略部分失败(应返回包含成功与失败的 BatchResult)、缺少输入校验(应在 API 边界用 Pydantic 提前校验)。资源类:资源未关闭(应使用上下文管理器)、异步中阻塞调用(应使用 async 原生库如 asyncio、httpx)。类型安全类:缺少类型注解、集合缺少类型参数。测试类:只测正常路径、过度 mock(关键路径宜用集成测试,仅 mock 外部服务)。
使用方式:作为评审清单在定稿前逐项核对,包括是否集中超时/重试、是否双重重试、是否硬编码配置、是否暴露内部类型、是否混杂 I/O 与业务逻辑、是否有裸 except、是否忽略批量部分失败、是否缺少输入校验、是否未关闭资源、异步中是否阻塞、公共函数是否都有类型注解、集合是否有类型参数、是否测试错误路径与边界情况。
适用场景:代码评审、调试、教学、团队规范制定、遗留代码重构。
限制:资料未提供安装命令、运行方式、平台支持、收费或价格信息,暂未提供;本技能为检查清单性质,不替代具体项目规范。