用途:这是一份 Python 代码常见错误与反模式的参考清单,适合在代码合并前审查、排查疑难问题、教学或学习 Python 最佳实践、制定团队编码规范以及重构遗留代码时使用。该技能聚焦于"应避免什么",若需正向设计模式与架构指导,可参考 python-design-patterns 技能。
主要能力:覆盖多类反模式。基础设施方面,检查超时/重试逻辑是否分散、是否存在多层重复重试、是否硬编码配置或密钥。架构方面,检查是否暴露内部类型(如 ORM 模型)、I/O 与业务逻辑是否混杂。错误处理方面,检查是否裸捕获 Exception、是否忽略批量部分失败、是否缺少输入校验。资源方面,检查资源是否未关闭、异步代码中是否有阻塞调用。类型安全方面,检查公共函数是否缺少类型标注、集合是否缺少类型参数。测试方面,检查是否只测正常路径、是否过度使用 mock。
使用方式:作为审查清单逐项核对。文中给出反例与修复方向,例如分散重试应集中到装饰器或客户端封装,硬编码配置应改用环境变量与 pydantic-settings 等类型化设置,暴露 ORM 模型应改用 DTO/响应模型,I/O 与逻辑混杂应使用仓储模式,裸捕获应捕获具体异常并记录或处理,批量任务应返回包含成功与失败的结果,输入应在边界处用 Pydantic 校验,资源应使用上下文管理器,异步中应使用原生异步库,公共 API 应补充类型标注,测试应覆盖错误路径与边界情况。
限制:资料以清单和代码示例形式呈现,未提供安装命令、运行方式、平台、收费或效果等信息,暂未提供。