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