• 请不要在回答技术问题时复制粘贴 AI 生成的内容
yoyoluck
V2EX  ›  程序员

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

  •  
  •   yoyoluck · 9h 23m ago · 1993 views

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

    22 replies    2026-07-31 01:14:19 +08:00
    crocoBaby
        1
    crocoBaby  
       8h 58m ago
    不是吧,今天刚加的注释 agent
    whitehack
        2
    whitehack  
       8h 56m ago
    能不能说清楚你用的是啥 AI.先避个坑
    colom
        3
    colom  
       8h 46m ago
    注释是给人看的
    weirwei
        4
    weirwei  
       8h 43m ago
    其实应该是 规范 AI 不要写错误/不确定的注释
    anghunk
        5
    anghunk  
       8h 39m ago
    我都让 AI 自己写注释,我看都不看的
    kristofer
        6
    kristofer  
       8h 38m ago
    注释都让 AI 写,AI 读,AI 改完代码同步改注释。
    582033
        7
    582033  
       8h 29m ago
    最近遇到一个类似的问题,AI 重复造轮子,代码不复用。

    感觉跟题主问题很像,我个人觉得像注释、复用这些都是给人看的,AI 时代这些是不是都可以忽略了?
    yidinghe
        8
    yidinghe  
    PRO
       8h 25m ago via Android   ❤️ 1
    哪天 AI 突然用不了了,你就哭去
    Oktfolio
        9
    Oktfolio  
       7h 58m ago
    @yidinghe 不存在这个可能
    Hstar
        10
    Hstar  
       7h 56m ago
    你的问题是注释和代码对不上, 解决问题的办法是让 AI 把注释写对, 而不是因噎废食.
    有注释能极大加速 AI 排查定位 bug 的速度, 降低 token 消耗, 可以搜搜相关研究. 同时注释也是给人看的, 总不能你这项目以后没活人写代码了吧
    jko123
        11
    jko123  
       7h 41m ago
    你太小看现在的 ai 了吧,你就算函数乱命名,都能给你梳理清楚
    asen1987
        12
    asen1987  
       5h 20m ago
    因为上下文的关系,个人反而认为,现在更有必要写注释了。当然,是让 AI 自己来写,写给 AI 看。甚至可以专门做一个注释方案和规范来提高效率。
    Blulotus
        13
    Blulotus  
       5h 5m ago
    注释错,AI 跟着错,这个是 AI 的问题。这个要规范 AI ,让 AI 根据事实来确定。有时候自己脑子蒙了,给的输入信息有时候不小心写错了,AI 会去核实纠正过来
    Coder0
        14
    Coder0  
       4h 37m ago
    不对吧,Agent 修改代码时会同步修改注释和单测的。
    longlongbig78
        15
    longlongbig78  
       4h 28m ago
    那能不能直接告诉 ai 有可能出错,注释是过时的且是给人看的,或者搞两个版本(无注释和有注释)?
    不过 ai 一般不会因为这个犯错吧(
    kneo
        16
    kneo  
       4h 16m ago via Android
    什么年代了,还觉得注释是给人看的?

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

    用了这么多年 AI 的程序员,认知还停留在史前。
    yoyoluck
        17
    yoyoluck  
    OP
       3h 41m ago
    @whitehack A/的 Opu 和 Fable 都会出现,AI 写的代码出现 bug ,让再三测试确认后就会说不好意思,之前的注释误导了我。
    Chuckle
        18
    Chuckle  
       2h 42m ago
    肯定的,你让谁去看一个几十万代码的多仓项目,没有业务文档,没有架构设计文档,什么信息都没有,也是一头雾水,能力再强也只能猜着改,测着改,一个字段状态流转都要推半天。所以,怎么让 AI 认识项目,就是个难题了,agent 产品再强,什么 repo wiki ,也最多梳理猜测一个项目仓库的信息,不提供私域知识,写代码就是抽奖。另外我也发现,如果 AI 前置信息越多,AI 其实越愿意写注释,相反,可能还会把原来的注释删了。而且 AI 做错猜错事才是最有价值的,说明信息缺失,你可以教会 AI ,然后自动沉淀到记忆或者知识库里,下次遇到相似的事情,就不会错了。
    techmale
        19
    techmale  
       2h 35m ago
    这个时代核心如下,它们比纠结注释重要 10000000 倍
    - SOP/*.md
    - AGENTS.md, README.md
    - tests/, self-descriptive & context-free variables + functions + files
    - Wiki
    deplives
        20
    deplives  
       2h 29m ago
    没遇到过,反而我的 5.6 或者 opus 5 会告诉我,注释/文档内容有误,已经帮我修改了
    y1y1
        21
    y1y1  
       1h 41m ago
    二进制都能看明白,别说注释了
    jh623
        22
    jh623  
       7 mins ago
    ai 自己写的注释改的时候会一起改啊,都是同步的,注释还是要的,方便审查代码
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1246 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 65ms · UTC 17:22 · PVG 01:22 · LAX 10:22 · JFK 13:22
    ♥ Do have faith in what you're doing.