修复遗漏同类代码,占项目缺陷近四分之一
作者按缺陷形态复盘项目的53条记录,发现13条源于同一问题:一处代码已修复,复制实现或相邻路径仍保留原缺陷。案例涉及分页处理和网络异常捕获,揭示重复实现带来的修复同步风险。
AI 深度解读
一个查重函数修好了分页,另一个入口还只检查第一页。作者回看自己维护的 MCP 服务和发布流水线,从 6 月以来的 53 条缺陷记录里找出 13 条同类问题,约占 24.5%。这些缺陷有个共同点,修复只落到一处,另一条路径还留着同一个 bug。
这篇复盘可以直接用在代码审查里。除了确认当前入口修好了,还要找出哪些入口共享同一条规则。作者试了两种查法,也发现即使代码已经同步,记录副本数量的注释仍会过期。
为什么搜日志只能找到 6 条?
作者把 docs/project_notes/bugs.md 里的 53 条记录从头读了一遍,按根因归类。2026-08-09 的记录写得很直白,publish_devto.py 给标题查重补了分页,server.py 的 create_article 却没跟上。查重只看第一页,后面的同名文章就会漏掉。2026-08-08 的记录也一样,publish_devto.py 早 5 天补上了 URLError 处理,server.py 的 _gh、_dev 和 reply_comments.py 的 api() 仍然只捕获 HTTPError。一条路径能处理连接失败,其他路径遇到同样的情况还会抛出异常。
有些记录得读完根因才能认出来。2026-08-15,check_key_facts.py 只校验了 3 份记忆文件中的 2 份,漏掉的恰好是 CLAUDE.md 规定优先检索的那份。2026-08-17,pending() 已经会遍历有分支的评论树,audit() 处理同样的树结构,却漏了分支。甚至同一份文档也会出问题。2026-08-12 的记录里,ADR-002 重复了 ADR-001 已经纠正的说法,声称某个文件存在。检查器按文件名豁免,把同文件里的这段错误也放了过去。
作者用 sibling、twin、copy 和 identical 搜日志,只找到 13 条里的 6 条。剩下 7 条靠阅读根因找到。搜索词能帮你定位已经被命名的问题,人工读的是哪些地方承担了同样的责任。两者找到的范围不同。
同名函数能帮你找到哪些漏改点?
作者用下面这段 Python 扫描仓库根目录和 scripts/ 直接包含的 .py 文件,列出在多个文件中定义的同名函数。
import ast, pathlib, collections
files = list(pathlib.Path(".").glob("*.py")) + list(pathlib.Path("scripts").glob("*.py"))
names = collections.defaultdict(list)
for f in files:
tree = ast.parse(f.read_text())
for node in ast.walk(tree):
if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
names[node.name].append(str(f))
for n, fs in sorted(names.items()):
if len(set(fs)) > 1:
print(n, "->", fs)
len(set(fs)) > 1 按文件去重,所以同一个文件里重复出现的名字不会单独触发输出。AST 是抽象语法树,这里靠它识别真正的函数定义,普通函数和异步函数都能收进去。
这次扫描报出了 2 个文件里的 _claude_subprocess_env、5 个文件里的 load_env,以及 4 个脚本里的 main。main 出现在多个脚本里很正常。load_env() 更值得逐个打开看,因为 2026-08-12 的缺陷就出在这里。当时 4 份实现里,server.py 那份既没去掉键名两端的空白,也没去掉值两端的引号。
作者检查了现在的 5 份实现,发现环境变量写入这一步已经一致。
os.environ.setdefault(k.strip(), v.strip().strip('"').strip("'"))
这行会清理键名和值,也会通过 setdefault 保留进程里已有的环境变量。代码已经对齐,server.py 和另外 3 处注释却仍沿用「4 份中的 1 份」。原文又提到事后新增了 2 份,没有交代旧的 4 份如何变成现在的 5 份。能确认的是,当前扫描找到了 5 处,作者逐一检查过它们。
我的判断
这次复盘测到的是一个小仓库的历史缺陷构成。13/53 约为 24.5%,略低于四分之一。这 53 条是缺陷日志的条目,不能据此计算所有修复的漏改率。作者也还没给出采用新流程后的对照数据,把扫描结果写进修复记录能不能减少漏改,目前仍是经验判断。
我赞成把同名扫描当成审查入口。它能快速拉出候选,也会带上 main 这样的同名函数,还漏得掉名称不同的 pending() 和 audit()。如果多处入口确实共享一条规则,一组共用的回归用例更能验证行为是否一致。至于提取公共模块,作者提到每份 load_env() 只有 6 行,调用方式却有 path=None、必传 path 和无参数几种,路径还相对于不同的基准目录解析。在这个仓库里,先检查各入口的行为,比为了去重先统一整个函数签名更容易落地。
能拿来做什么
- 用 AI 修 bug 时,先让它在仓库里搜函数名和相关行为,再列出同类入口。修查重分页时,要求它分别确认每个入口如何取下一页。
- 在 Node.js 项目里,如果命令行脚本和服务端都读取环境变量,可以给两边跑同一组用例,覆盖键名空白、带引号的值和已存在的环境变量。
- 关闭缺陷时,在修复记录里贴上带日期的扫描结果,并注明实际检查了哪些入口。后续新增脚本时,可以重跑扫描来确认当前范围。