进行了好久的 vibe coding 了，使用发现在 AICoding 时代，尽量不要写注释。写了注释之后 AI 会根据注释理解代码逻辑，注释写错了 AI 都大概率跟着理解错！！！
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
 |
1
crocoBaby 1 day ago
不是吧,今天刚加的注释 agent
|
 |
2
whitehack 1 day ago
能不能说清楚你用的是啥 AI.先避个坑
|
 |
3
colom 1 day ago
注释是给人看的
|
 |
4
weirwei 1 day ago
其实应该是 规范 AI 不要写错误/不确定的注释
|
 |
5
anghunk 1 day ago
我都让 AI 自己写注释，我看都不看的
|
 |
6
kristofer 1 day ago
注释都让 AI 写，AI 读，AI 改完代码同步改注释。
|
 |
7
582033 1 day ago
最近遇到一个类似的问题，AI 重复造轮子，代码不复用。
感觉跟题主问题很像，我个人觉得像注释、复用这些都是给人看的，AI 时代这些是不是都可以忽略了？ |
 |
8
yidinghe PRO  1
哪天 AI 突然用不了了，你就哭去
|
 |
10
Hstar 1 day ago 1
你的问题是注释和代码对不上, 解决问题的办法是让 AI 把注释写对, 而不是因噎废食.
有注释能极大加速 AI 排查定位 bug 的速度, 降低 token 消耗, 可以搜搜相关研究. 同时注释也是给人看的, 总不能你这项目以后没活人写代码了吧 |
 |
11
jko123 1 day ago
你太小看现在的 ai 了吧，你就算函数乱命名，都能给你梳理清楚
|
 |
12
asen1987 1 day ago
因为上下文的关系，个人反而认为，现在更有必要写注释了。当然，是让 AI 自己来写，写给 AI 看。甚至可以专门做一个注释方案和规范来提高效率。
|
 |
13
Blulotus 1 day ago
注释错，AI 跟着错，这个是 AI 的问题。这个要规范 AI ，让 AI 根据事实来确定。有时候自己脑子蒙了，给的输入信息有时候不小心写错了，AI 会去核实纠正过来
|
 |
14
Coder0 23h 43m ago
不对吧，Agent 修改代码时会同步修改注释和单测的。
|
 |
15
longlongbig78 23h 34m ago
那能不能直接告诉 ai 有可能出错，注释是过时的且是给人看的，或者搞两个版本（无注释和有注释）？
不过 ai 一般不会因为这个犯错吧（ |
 |
16
kneo 23h 21m ago via Android
什么年代了，还觉得注释是给人看的？
“注释是给人看的”，下一句潜台词是“不是给编译器看的”。 用了这么多年 AI 的程序员，认知还停留在史前。 |
 |
17
yoyoluck OP @whitehack A/的 Opu 和 Fable 都会出现，AI 写的代码出现 bug ，让再三测试确认后就会说不好意思，之前的注释误导了我。
|
 |
18
Chuckle 21h 48m ago
肯定的，你让谁去看一个几十万代码的多仓项目，没有业务文档，没有架构设计文档，什么信息都没有，也是一头雾水，能力再强也只能猜着改，测着改，一个字段状态流转都要推半天。所以，怎么让 AI 认识项目，就是个难题了，agent 产品再强，什么 repo wiki ，也最多梳理猜测一个项目仓库的信息，不提供私域知识，写代码就是抽奖。另外我也发现，如果 AI 前置信息越多，AI 其实越愿意写注释，相反，可能还会把原来的注释删了。而且 AI 做错猜错事才是最有价值的，说明信息缺失，你可以教会 AI ，然后自动沉淀到记忆或者知识库里，下次遇到相似的事情，就不会错了。
|
 |
19
techmale 21h 41m ago 1
|
 |
20
deplives 21h 35m ago
没遇到过，反而我的 5.6 或者 opus 5 会告诉我，注释/文档内容有误，已经帮我修改了
|
 |
21
y1y1 20h 46m ago
二进制都能看明白，别说注释了
|
 |
22
jh623 19h 13m ago
ai 自己写的注释改的时候会一起改啊，都是同步的，注释还是要的，方便审查代码
|
 |
23
Mandelo 18h 31m ago via Android
我必须要 ai 生成业务代码时候写好注释。不然你新开会话或者上下文丢了或者换个别的 ai 理解代码又容易出问题。不是，都 vibe coding 了还自己手写注释呢？
|
 |
24
night98 13h 1m ago
肯定要写注释啊，一千行的函数注释可以写五行就说清楚这个函数是干嘛的
|
 |
25
chendy 11h 52m ago
AI 写的代码 AI 自己维护注释，自己写的代码让 AI 生成/调整注释，让 AI 参考代码一般让它无视注释只看代码逻辑
之前排查一个老 BUG 一直查不出来，后来发现 AI 优先按照注释的说法理解了，然而注释是二十年前的跟现在完全不一样  |
 |
26
HappyAndSmile 11h 8m ago
你说的不太对，历史代码的错误注释或者注释不一致确实会对 AI 造成影响了，这个我最近也发现了，但是新代码还是可以让 AI 写注释的
|
 |
27
Sezxy 10h 22m ago
改老项目经常遇到的问题，代码变了注释没人动，就容易让 AI 跑偏，gpt5.5 遇到几次
|
 |
28
EspoirBao 10h 14m ago
@yidinghe 和哪天互联网断了你连 v 站都上不了，哪天美团没了可能饭都没得吃这不是差不多？ 26 年了，ai 大模型已经在事实上变成了基础设施，可能运营的公司会一直变化，但是这个缺口一定有人补上
 |
 |
29
aydenagel381 10h 12m ago
ai slop 是一定会有的，参考 openai 的做法，定期启动 gc agent 去做这种文档漂移的问题治理。
|
 |
30
bhagavad 9h 53m ago
代码就是最好的注释
|
 |
32
Orenoid 9h 49m ago
现在有 AI 后，注释更应该注重于「这段代码为什么要这么做」而不是「这段代码在做什么」了，后者没有必要且确实容易出现你说的不一致的问题
|
 |
33
xz410236056 9h 42m ago
注释不都是 AI 根据要求自己生成的吗，它生成的代码和注释有什么本质区别。注释还能给人类看看
|
 |
34
en7en 9h 31m ago
在规则中写上读取代码时过滤注释不就行了
|
 |
35
a1562619919 9h 27m ago
注释不一定是错的，有可能是版本迭代需求变动，方便 AI 了解 git 提交历史，人会被误导但是 AI 基本不会。这暴论类似于不要写 CLAUDE.md/AGENT.md ，文档只是维护频率低不等于可以当传家宝
|
 |
36
HHA 9h 1m ago
注释会污染上下文，不管是自己写的还是 ai 写的
|
 |
37
sunkwei 6h 58m ago
我会主动提示：这个模块不是给人类看的，使用 AI 易理解的方式实现 :)
|
 |
38
ttkit 6h 42m ago
不要写注释，以前注释是写给人看的，注释是帮助人了解代码。
但是 AI 不需要注释，因为他能看懂代码，加了注释反而容易让 AI 分析错误。 不信，你问 AI 。 |
 |
39
Felldeadbird 6h 23m ago
规则增加说明就好了：优先以代码为结果导向，注释和文档作为参考。存在与代码导向错误的，请指出并修改。
这样就会好很多了。 |
 |
40
lewurui 5h 36m ago
AI 时代完全没有写注释的不要，代码就是注释，哪里看不懂让 AI 给你解读
|
 |
42
Newb1e 5h 25m ago
是这样的，要是有注释，ai 还得修改两个地方，注释也不如代码好查找，最好注释就是简单说明一下，一句话概括（人类方便查看），其他就是流程上的说明，这样的不如单独放一个文档，还方便审阅。
|
 |
46
kulove 5h 20m ago via Android
不要写 有时候会造成 AI 的错觉 部分情况上下文读不到 会存在注释没更新的情况 况且也浪费 token
|
Select Language