基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-22 11:46

修复遗漏同类代码,占项目缺陷近四分之一

dev.to · AI#缺陷复盘#代码维护
Editor brief · 编辑速览

作者按缺陷形态复盘项目的53条记录,发现13条源于同一问题:一处代码已修复,复制实现或相邻路径仍保留原缺陷。案例涉及分页处理和网络异常捕获,揭示重复实现带来的修复同步风险。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 项目里,如果命令行脚本和服务端都读取环境变量,可以给两边跑同一组用例,覆盖键名空白、带引号的值和已存在的环境变量。
  • 关闭缺陷时,在修复记录里贴上带日期的扫描结果,并注明实际检查了哪些入口。后续新增脚本时,可以重跑扫描来确认当前范围。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
Shelly 如何隔离 MCP 审批与只读请求
下一篇
用编程 Agent 先审计依赖再迁移

资讯速览

dev.to · AI · 2026-11-22 11:46

AI 评分 8.0 / 10

相关标签

#缺陷复盘#代码维护

继续阅读

  • Agent 接口重试如何避免重复写入和流量尖峰
  • Shelly 如何隔离 MCP 审批与只读请求
  • 用编程 Agent 先审计依赖再迁移
  • AI 生成任务如何用 PostgreSQL 原子结算
  • 用 Spring AI 串联四步数据处理