用途:在宣布任务完成前,对改动做一次“收尾检查”,找出并处理遗留问题,避免把调试残留、未用代码和未完成事项带入提交。
主要能力:按清单检查代码卫生(未使用导入/变量、注释掉的代码、console.log/print、debugger)、TODO 与 FIXME、测试(新代码是否有测试、既有测试是否通过、边界情况)、类型(是否新增 any、无理由的类型断言、新结构是否有类型定义)、引用(重命名后旧引用、断裂导入、过期注释)、错误处理(是否处理或显式抛出、面向用户的错误信息、静默失败)。
使用方式:可运行自动扫描脚本 python scripts/sweep.py,它会查找 console.log、print()、debugger、TODO/FIXME/XXX/HACK 以及 dd()、var_dump()、binding.pry 等。也可用快速命令,例如:git diff --name-only | xargs grep -n "TODO|FIXME";git diff --name-only | xargs grep -n "console.log";npx tsc --noEmit 2>&1 | grep "declared but";git diff | grep ": any"。
适用场景:提交或交付前的自查,尤其是新增接口、修改多文件、做过实验性改动之后。
限制:资料未说明支持的语言范围、安装方式、收费与平台信息;清单中的类型检查等条目标注为“如适用”。