SuperAPI AI 工具集

python-anti-patterns

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:本技能是一份 Python 反模式参考清单,用于代码审查、调试疑难问题、教学、制定团队编码规范以及重构遗留代码。它聚焦“应避免什么”,正向模式与架构可参考 python-design-patterns 技能。

主要能力:覆盖多类常见问题。基础设施方面,指出超时/重试逻辑分散、双层重复重试、硬编码配置与密钥;架构方面,指出暴露 ORM 等内部类型、I/O 与业务逻辑混杂;错误处理方面,指出裸 except 吞异常、批量处理遇错即停、缺少输入校验;资源方面,指出未关闭资源、在异步中阻塞事件循环;类型安全方面,指出缺少类型注解、集合无类型参数;测试方面,指出只测正常路径、过度 mock。

使用方式:作为清单在定稿前逐项核对,例如确认重试逻辑集中、配置来自环境变量、对外返回 DTO、业务逻辑保持纯净、捕获具体异常、批量返回成功与失败结果、边界处用 Pydantic 校验、使用上下文管理器、异步用原生库、公共函数有类型注解、错误路径与边界情况有测试。

适用场景:代码合并前审查、排查神秘问题、团队规范建设、遗留代码重构。

限制:需要具体项目上下文与技术栈信息;不处理非技术业务决策;仅提供指导,不提供具体代码实现。资料未提供安装命令、收费方式或平台信息。