vibe coding 需要养成不写注释的好习惯

[yoyoluck]

进行了好久的 vibe coding 了，使用发现在 AICoding 时代，尽量不要写注释。写了注释之后 AI 会根据注释理解代码逻辑，注释写错了 AI 都大概率跟着理解错！！！

[y1y1]

二进制都能看明白，别说注释了

[jh623]

ai 自己写的注释改的时候会一起改啊，都是同步的，注释还是要的，方便审查代码

[Mandelo]

我必须要 ai 生成业务代码时候写好注释。不然你新开会话或者上下文丢了或者换个别的 ai 理解代码又容易出问题。不是，都 vibe coding 了还自己手写注释呢？

[night98]

肯定要写注释啊，一千行的函数注释可以写五行就说清楚这个函数是干嘛的

[chendy]

AI 写的代码 AI 自己维护注释，自己写的代码让 AI 生成/调整注释，让 AI 参考代码一般让它无视注释只看代码逻辑
之前排查一个老 BUG 一直查不出来，后来发现 AI 优先按照注释的说法理解了，然而注释是二十年前的跟现在完全不一样

[HappyAndSmile]

你说的不太对，历史代码的错误注释或者注释不一致确实会对 AI 造成影响了，这个我最近也发现了，但是新代码还是可以让 AI 写注释的

[Sezxy]

改老项目经常遇到的问题，代码变了注释没人动，就容易让 AI 跑偏，gpt5.5 遇到几次

[EspoirBao]

@yidinghe 和哪天互联网断了你连 v 站都上不了，哪天美团没了可能饭都没得吃这不是差不多？ 26 年了，ai 大模型已经在事实上变成了基础设施，可能运营的公司会一直变化，但是这个缺口一定有人补上

[aydenagel381]

ai slop 是一定会有的，参考 openai 的做法，定期启动 gc agent 去做这种文档漂移的问题治理。

[bhagavad]

代码就是最好的注释

[lucassss]

@yidinghe 是停电了吗，那我只好手写了

[Orenoid]

现在有 AI 后，注释更应该注重于「这段代码为什么要这么做」而不是「这段代码在做什么」了，后者没有必要且确实容易出现你说的不一致的问题

[xz410236056]

注释不都是 AI 根据要求自己生成的吗，它生成的代码和注释有什么本质区别。注释还能给人类看看

[en7en]

在规则中写上读取代码时过滤注释不就行了

[a1562619919]

注释不一定是错的，有可能是版本迭代需求变动，方便 AI 了解 git 提交历史，人会被误导但是 AI 基本不会。这暴论类似于不要写 CLAUDE.md/AGENT.md ，文档只是维护频率低不等于可以当传家宝

[HHA]

注释会污染上下文，不管是自己写的还是 ai 写的

[sunkwei]

我会主动提示：这个模块不是给人类看的，使用 AI 易理解的方式实现 :)

[ttkit]

不要写注释，以前注释是写给人看的，注释是帮助人了解代码。

但是 AI 不需要注释，因为他能看懂代码，加了注释反而容易让 AI 分析错误。

不信，你问 AI 。

[Felldeadbird]

规则增加说明就好了：优先以代码为结果导向，注释和文档作为参考。存在与代码导向错误的，请指出并修改。

这样就会好很多了。

[lewurui]

AI 时代完全没有写注释的不要，代码就是注释，哪里看不懂让 AI 给你解读