改代码的门槛,几乎为零
系列第 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 次修改的基础上继续「修」,越修越乱,直到这个「验证通过」的版本彻底找不回来。回滚之所以有效,是因为我们事先留下了「可以回滚的地方」。
所以那天之后,我们把「后悔药」升级成了「自动闸门」:
- pre-commit 门控(L1’):
git commit之前,自动跑全量测试 + 质量比对,任何一步失败,commit 直接被拒绝——不再靠「记得要跑测试」。 - 可编程的验证入口(L2’):把交互式的质量校验改成
--non-interactive --json模式,让机器能自动调用、自动判结果。 - 「变差」的硬规则(L3’):什么叫「改坏了」,不再靠主观感觉——乱码多了、中文少了 10%、章节缺了,任中一条就算变差,脚本自动判。
从「门槛为零」,到「机器拦在 commit 之前」,这才是那 5 次修改真正该换来的东西。
可复用经验
- 越小越急的改动,越需要门控。 「调个阈值」「加一行」恰恰是最容易被放行、也最常引发回归的改动。
- 评审必须是机制,不能是自觉。 靠「记得要评审」没用,靠 pre-commit hook 拦住才有用。
- 先有基线,才有回滚。 回滚的价值 90% 取决于事前有没有留下那个「好版本」的快照。
- 回滚不是丢脸,是止损。 当你发现自己一整天在和上午的决定搏斗,果断 revert,比硬撑体面得多。
下一篇,我们看另一个更「隐蔽」的坑:一个默认参数,是怎么让工具一夜抓完整本书的。
下一篇预告:《一个默认参数,引发整本批量抓取》
- 点赞
- 收藏
- 关注作者
评论(0)