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

[yoyoluck]

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

[crocoBaby]

不是吧,今天刚加的注释 agent

[whitehack]

能不能说清楚你用的是啥 AI.先避个坑

[colom]

注释是给人看的

[weirwei]

其实应该是 规范 AI 不要写错误/不确定的注释

[anghunk]

我都让 AI 自己写注释，我看都不看的

[kristofer]

注释都让 AI 写，AI 读，AI 改完代码同步改注释。

[582033]

最近遇到一个类似的问题，AI 重复造轮子，代码不复用。

感觉跟题主问题很像，我个人觉得像注释、复用这些都是给人看的，AI 时代这些是不是都可以忽略了？

[yidinghe]

哪天 AI 突然用不了了，你就哭去

[Oktfolio]

@yidinghe 不存在这个可能

[Hstar]

你的问题是注释和代码对不上, 解决问题的办法是让 AI 把注释写对, 而不是因噎废食.
有注释能极大加速 AI 排查定位 bug 的速度, 降低 token 消耗, 可以搜搜相关研究. 同时注释也是给人看的, 总不能你这项目以后没活人写代码了吧

[jko123]

你太小看现在的 ai 了吧，你就算函数乱命名，都能给你梳理清楚

[asen1987]

因为上下文的关系，个人反而认为，现在更有必要写注释了。当然，是让 AI 自己来写，写给 AI 看。甚至可以专门做一个注释方案和规范来提高效率。

[Blulotus]

注释错，AI 跟着错，这个是 AI 的问题。这个要规范 AI ，让 AI 根据事实来确定。有时候自己脑子蒙了，给的输入信息有时候不小心写错了，AI 会去核实纠正过来

[Coder0]

不对吧，Agent 修改代码时会同步修改注释和单测的。

[longlongbig78]

那能不能直接告诉 ai 有可能出错，注释是过时的且是给人看的，或者搞两个版本（无注释和有注释）？
不过 ai 一般不会因为这个犯错吧（

[kneo]

什么年代了，还觉得注释是给人看的？

“注释是给人看的”，下一句潜台词是“不是给编译器看的”。

用了这么多年 AI 的程序员，认知还停留在史前。

[yoyoluck]

@whitehack A/的 Opu 和 Fable 都会出现，AI 写的代码出现 bug ，让再三测试确认后就会说不好意思，之前的注释误导了我。

[Chuckle]

肯定的，你让谁去看一个几十万代码的多仓项目，没有业务文档，没有架构设计文档，什么信息都没有，也是一头雾水，能力再强也只能猜着改，测着改，一个字段状态流转都要推半天。所以，怎么让 AI 认识项目，就是个难题了，agent 产品再强，什么 repo wiki ，也最多梳理猜测一个项目仓库的信息，不提供私域知识，写代码就是抽奖。另外我也发现，如果 AI 前置信息越多，AI 其实越愿意写注释，相反，可能还会把原来的注释删了。而且 AI 做错猜错事才是最有价值的，说明信息缺失，你可以教会 AI ，然后自动沉淀到记忆或者知识库里，下次遇到相似的事情，就不会错了。

[techmale]

这个时代核心如下，它们比纠结注释重要 10000000 倍
- SOP/*.md
- AGENTS.md, README.md
- tests/, self-descriptive & context-free variables + functions + files
- Wiki

[deplives]

没遇到过，反而我的 5.6 或者 opus 5 会告诉我，注释/文档内容有误，已经帮我修改了

[y1y1]

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

[jh623]

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

[Mandelo]

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