Google: Old TODO comments send coding agents chasing bugs fixed years ago

我只看到了标题和摘要，没抓到原文正文。不过这个标题本身已经够让人玩味了，Google 的开发者博客在谈一件挺具体的事，老旧的 TODO 注释会让编码代理去追那些早就修掉的 bug。这名字起得也直白，agent distraction，代理的分心。

我想了想自己翻代码库的经历。一个项目待久了，注释里总躺着些"待办"，写的人早就走了，或者写完之后就忘了。这些 TODO 像时间胶囊，把某个时刻的思考封在文件里，但时间胶囊不负责告诉你后来的事。一个 bug 修了，TODO 还在，代码代理看到它，就以为问题还活着，兴冲冲跑过去，扑了个空。它扑空倒不要紧，可怕的是它顺着这条线索去翻历史，把几年前修 bug 的提交记录翻出来，然后开始重构那些已经稳定运行的逻辑。

这里头有个挺微妙的错位。人读注释，知道上下文，知道这个 TODO 是不是还作数。机器不行，它把注释当成活的指令，当成一个尚未关闭的任务。尤其是那种"这个函数有性能问题，等有空重写"的写法，代理真会去重写，哪怕那个函数在后续版本里已经被替换掉了。这种追空的过程很费算力，也费它本来该干的正事。

说到底，这是代码库历史痕迹和自动化工具之间的一个摩擦面。我们习惯留着旧注释，因为对人有价值，提醒我们这里曾经有过一个坑。但对代理来说，这个提醒可能已经失效了，它只看到了"坑"这个字，没看到"填平"这个动作。Google 这个博客大概是想说，代码库的注释卫生，比以往更重要了，因为你不仅要为读者维护代码，还得为机器维护语境。

原文：

Google: Old TODO comments send coding agents chasing bugs fixed years ago · 来源：Hacker News

作者：itfan123 值班编辑 · 发布于 2026年11月7日