改代码的门槛,几乎为零

举报
yd_275474346 发表于 2026/11/10 09:08:05 2026/11/10
【摘要】 系列第 02 篇 · 治理根因 1/8一天之内改了 5 次,12 小时后我又亲手把它全部撤销。 一天,5 次修改,最后一把 revert先说那天的时间线,它现在看依然触目惊心。这是项目第一次「验证通过」之后的某一天。工具已经能稳定抓完整本书了,我们给它打了个基线快照(称为 67b9451),理论上,从这一刻起,任何改动都应该慎之又慎。结果那一天,我(或者说「我们和 AI」)在同一个文件上动了...

系列第 02 篇 · 治理根因 1/8
一天之内改了 5 次,12 小时后我又亲手把它全部撤销。


一天,5 次修改,最后一把 revert

先说那天的时间线,它现在看依然触目惊心。

这是项目第一次「验证通过」之后的某一天。工具已经能稳定抓完整本书了,我们给它打了个基线快照(称为 67b9451),理论上,从这一刻起,任何改动都应该慎之又慎。

结果那一天,我(或者说「我们和 AI」)在同一个文件上动了 5 次手:

  • 10:29 —— 把一个点击检测的阈值从 30 调到 200,理由是「更稳」;
  • 14:52 —— 打了一行补丁;
  • 17:10 —— 删了 38 行,去「修复」上午那个阈值改动引入的回归;
  • 19:14 —— 加了 16 行「改进」;
  • 21:47 —— 又加 18 行「恢复方案」。

到了晚上 10 点,我盯着那一堆越叠越高的改动,做了当天唯一正确的一件事:

git revert,全部撤销,回到 67b9451。

12 个小时,5 次修改,归零。

有人说这是「白忙活一天」,我不这么看。这一天至少换来了两样东西:一个清醒的认识(下面会讲),和一个「再也不敢直接改」的教训。某种意义上,这一天的 5 次修改,比我写过的任何一段「正确代码」都值钱——因为它逼着我把「门控」这件事,从嘴上的共识,变成了机器上的闸门。

每次「小小的改动」,都带了破坏

这 5 次修改,没有一次是「恶意」的。恰恰相反,每一次都又小又合理——调个阈值、打个补丁、加个判断。

但它们合起来,实实在在地把项目改崩了:

  • 35 章的备份内容,居然比新版本还完整——这说明某次改动让抓取漏了东西;
  • 书籍封面开始跨章混入正文——边界判断被改坏了;
  • 第 37 章内容严重不足——阈值改动让它误入了另一个降级分支,抓到的字少得可怜。

最讽刺的是:上午 10 点半改的那个阈值,下午 5 点我在修复它引入的回归,晚上 9 点还在「恢复方案」。我花了一整天,在和自己上午的决定搏斗。

根因:改代码的门槛,是零

回头复盘,这 5 次修改能一路畅通无阻地混进去,根因就一条——改代码的门槛几乎为零。

拆开看,三个层面,层层真空:

技术层面:零自动门控。 项目的 .git/hooks/ 目录当时是空的,没有 pre-commit hook;npm test 虽然存在(而且有 116 个用例),但是没人强制跑——改完代码,git commit 直接过,没有任何机器会拦住你。

流程层面:评审是「文档」不是「强制」。 规则文件里写着「修改要双方共识」,但那是自然语言,不是机制。没有东西去验证「共识」到底达没达成,评审标记甚至可以被随手写上。

行为层面:修复冲动 + 小改麻痹。 「就改一行,不会出事的」——这是最危险的一句话。改动越小,人越放松警惕,越不会去完整回归。而那天的 5 次修改,正是从「就调个阈值」开始的。

三层真空叠加起来的结果是:一个已经验证通过的版本,可以被任何人(包括 AI)在没有任何阻拦的情况下,随手改崩。

还有一个被忽视的层面:反馈延迟。那天上午 10 点半改的阈值,引入的回归直到 7 小时后才被发现;而全部撤销,又拖到 12 小时后。反馈滞后让「改 → 发现问题 → 再改」的循环持续了 5 次,每一次都以为「这次修好了」——因为后果还没传到眼前。如果反馈是秒级的,5 次修改在第 2 次就会被拦下;正因为反馈是小时级的,错误才一路累积到不可收拾。

这里要特别说一句 AI。很多人以为「有 AI 写代码,质量更有保障」,但恰恰相反——AI 的效率和「门槛为零」是绝配。AI 改代码太快了,一分钟能给出好几个「优化建议」,如果每个建议都不经过评审就能落地,那「修复冲动」和「小改麻痹」会被放大到极致:你甚至来不及一个个思考,就已经 commit 了一串「看起来都对」的改动。

门槛越松,AI 越快,崩得越彻底。这就是为什么「自动门控」在 AI 时代反而更关键。

救场的是回滚,但回滚不该是常态

那天晚上,救场的动作非常简单:git revert,回到基线。

但请你想清楚一个问题:如果我们没有给 67b9451 打过基线,那天晚上会发生什么?

答案是:我会在 5 次修改的基础上继续「修」,越修越乱,直到这个「验证通过」的版本彻底找不回来。回滚之所以有效,是因为我们事先留下了「可以回滚的地方」。

所以那天之后,我们把「后悔药」升级成了「自动闸门」:

  1. pre-commit 门控(L1’):git commit 之前,自动跑全量测试 + 质量比对,任何一步失败,commit 直接被拒绝——不再靠「记得要跑测试」。
  2. 可编程的验证入口(L2’):把交互式的质量校验改成 --non-interactive --json 模式,让机器能自动调用、自动判结果。
  3. 「变差」的硬规则(L3’):什么叫「改坏了」,不再靠主观感觉——乱码多了、中文少了 10%、章节缺了,任中一条就算变差,脚本自动判。

从「门槛为零」,到「机器拦在 commit 之前」,这才是那 5 次修改真正该换来的东西。

可复用经验

  1. 越小越急的改动,越需要门控。 「调个阈值」「加一行」恰恰是最容易被放行、也最常引发回归的改动。
  2. 评审必须是机制,不能是自觉。 靠「记得要评审」没用,靠 pre-commit hook 拦住才有用。
  3. 先有基线,才有回滚。 回滚的价值 90% 取决于事前有没有留下那个「好版本」的快照。
  4. 回滚不是丢脸,是止损。 当你发现自己一整天在和上午的决定搏斗,果断 revert,比硬撑体面得多。

下一篇,我们看另一个更「隐蔽」的坑:一个默认参数,是怎么让工具一夜抓完整本书的。


下一篇预告:《一个默认参数,引发整本批量抓取》

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。