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

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

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

注释是给人看的

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

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

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

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

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

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

@yidinghe 不存在这个可能

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

代码就是最好的注释

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

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

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

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

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

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

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

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

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

不信，你问 AI 。