用途:在代码质量审计之后,系统性修复被识别出的坏编码实践,遵循 fail-fast 原则,让错误尽早暴露而非被静默吞掉。适用于运行代码质量审计后、修复特定坏模式、重构提升代码质量或作为质量工作流的一部分自主执行。
主要能力:提供多类修复模式,包括将裸 except: pass 改为捕获特定异常并记录日志再抛出;将宽泛的 except Exception 收窄为具体异常;把静默 continue 改为显式报错、集中收集错误或至少记录警告;把出错返回 None 改为抛出异常;把错误返回码改为异常;把防御性 None 检查改为快速失败或优雅处理;为 subprocess 调用添加 check=True 与异常处理;清理无意义的捕获-记录-重抛。还包含日志配置与级别(debug/info/warning/error/exception/critical)、惰性格式化等日志最佳实践,以及异常处理决策树、合法异常处理场景(输入校验、可选依赖降级、资源清理、重试逻辑、边界错误转换)、错误路径测试和提交信息模板。
使用方式:先运行代码质量审计,或用 grep 模式直接定位问题;按严重程度分类(裸 except pass 为严重、宽泛 except 为高、静默继续与缺失日志为中、出错返回 None 为低);逐项理解原意并套用修复模式,补充错误条件测试;再用 pytest、ruff 验证并重跑审计。
限制:自动化修复脚本仅适用于简单模式,提交前必须人工审查并运行测试,存在风险。具体安装命令与依赖在资料中暂未提供。