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

注释写得太多了会挨打吗?

  •  
  •   fundebug · Sep 25, 2018 · 19179 views
    This topic created in 2978 days ago, the information mentioned may be changed or developed.

    145 replies  •  2018-09-27 18:27:25 +08:00
    1  2  
    ❮ ❯
    Harlaus
    Harlaus
    Sep 26, 2018
    101
    注释永远不嫌多
    注释永远不嫌多
    注释永远不嫌多
    Harlaus
    Harlaus
    Sep 26, 2018
    102
    注释永远不嫌多
    jacatch
    jacatch
    Sep 26, 2018
    103
    其他语言我不好说,反正 java 里,如果在方法里面写注释,不单独拿出一行写,我绝对会 neng 死他
    jlyybz
    jlyybz
    Sep 26, 2018
    104
    喜欢这样的人 除了特别牛的大佬 应该都不会觉得注释多
    qfpZ2KhNsF23UGbN
    qfpZ2KhNsF23UGbN
    Sep 26, 2018
    105
    硬盘空间不足的时候可能会
    DiamondY
    DiamondY
    Sep 26, 2018
    106
    注释写“太多”的话,看代码的时候翻白眼,鄙视是肯定有的,至于动不动手去打,就看心情了
    qingfengxm
    qingfengxm
    Sep 26, 2018
    107
    注释多少都不怕,怕的是注释和代码版本不同步,代码是新代码注释是旧代码的注释,注释就没什么卵用了
    calpamomo
    calpamomo
    Sep 26, 2018
    108
    这个应该是 JSDoc 吧,不怕的
    icySoda
    icySoda
    Sep 26, 2018
    109
    写注释的三个层次:
    1. 什么代码都不写注释
    2. 什么代码都写注释
    3. 只在关键处(难理解处 /易出错处 /易混淆处)写注释



    同事也喜欢写很多注释, 还要求我也跟他一样写, 烦得要死
    200 行的代码, 500 行的注释, 而且注释跟代码还不一样.
    注释里参数是字符串类型, 代码里却是布尔类型.
    Joyboo
    Joyboo
    Sep 26, 2018
    110
    多了会不会挨打我不知道,但少了肯定会挨打
    chungzhao
    chungzhao
    Sep 26, 2018
    111
    适可而止
    kiinlam
    kiinlam
    Sep 26, 2018
    112
    简单扼要就行,能生成文档更好,有小 demo 最佳
    zhangZMZ
    zhangZMZ
    Sep 26, 2018
    113
    太多?什么是多?多少是多,多少是少?
    libook
    libook
    Sep 26, 2018❤️1
    114
    寻其根本,写注释是为了什么?

    对于这个问题,我的答案是:能让大多数人轻松看懂我的代码,简而言之就是提高可读性。

    而提高可读性不一定就要靠尽可能多地写注释,甚至不一定要靠注释,不管你用什么办法,只要达到了“能让大多数人轻松看懂我的代码”的目标就可以了。

    注释越多就越能越轻易看懂吗?
    不一定,像《三傻大闹宝莱坞》里主角用了一大串“定义”来描述“书”的时候,教授完全没听懂是什么。
    但有的时候算法真的非常复杂,少一点注释就解释不清楚,这时候不妨吧代码拆一拆,分段由浅及深写注释,可能效果会更好一些,想象一下如何才能给一个对物理学完全不了解的小学生讲明白相对论。
    laike9m
    laike9m
    Sep 26, 2018 via Android
    115
    有比没有好。
    但更好的做法或许是让变量名本身就体现出其含义,作用。
    victorywangzhcn
    victorywangzhcn
    Sep 26, 2018
    116
    此处应该 @syhily
    ica10888
    ica10888
    Sep 26, 2018
    117
    不会
    wangccddaa
    wangccddaa
    Sep 26, 2018
    118
    我记得有句话:真正好的代码是不需要注释的,如果你需要大量注释来解释你的代码,那说明你的代码还是不够好
    taevas
    taevas
    Sep 26, 2018
    119
    @wangccddaa 说的比唱的好听,在座的都几十年开发?就算给个几十年,代码写出来不还是那 b 样嘛。加点注释很有必要
    kx5d62Jn1J9MjoXP
    kx5d62Jn1J9MjoXP
    Sep 26, 2018
    120
    不会
    但是会因为进度太慢挨打
    chengkai1853
    chengkai1853
    Sep 26, 2018
    121
    @easylee github 上从来没见过你说的这种 2:1 项目,还是大佬们的项目太渣了? 求给个 2:1 项目做模板看看!😝
    xifangczy
    xifangczy
    Sep 26, 2018
    122
    略多了点,精简下语言 还行。
    tonychow
    tonychow
    Sep 26, 2018
    123
    如果遗留了旧实现的注释或者忘了更新就会被打
    jmk92
    jmk92
    Sep 26, 2018
    124
    让我想起来,过去一同事,工作提前做完做完了没事干,疯狂写注释。
    wolfie
    wolfie
    Sep 26, 2018
    125
    就喜欢这种注释多的。

    调用没有注释的烂代码,不知道要浪费多少时间。
    whnzy
    whnzy
    Sep 26, 2018
    126
    每行 79 个字符(逃
    maemolee
    maemolee
    Sep 26, 2018
    127
    不嫌麻烦的话,最好能把注释写的淋漓尽致的,别人看起来方便。
    pynix
    pynix
    Sep 26, 2018
    128
    很多代码可以自注释就不用写了。。
    jones
    jones
    Sep 26, 2018 via Android
    129
    翻翻开源项目的源代码,spring, hibernate 这些,注释通常都比代码行数多,尤其是 public 的 API,
    easylee
    easylee
    Sep 26, 2018 via Android
    130
    @chengkai1853

    非常抱歉,是我的错误,没有指明这个比例的出处。
    1/2 的比例是我在很久以前的代码规范的书本上看到的,那本册子我已经找不到了。

    不过内容依稀记得,你所指的 git 上面的来源项目注释不多,可能大多因为有手册或者文档,并未做成注释。
    pkoukk
    pkoukk
    Sep 26, 2018
    131
    不会挨打,但是你这样写的问题是,如果你的函数修改了,还有一大片文档要改,如果改函数不改文档,会被打死。还不如不写
    konakona
    konakona
    Sep 26, 2018
    132
    你这个还只是变量注释。变量有注释很重要哦!
    konakona
    konakona
    Sep 26, 2018
    133
    这样写严格来说是不规范的,IDE 不友好。
    比如说我再其他地方或者这个文件的下面,按 ctrl 剑鼠标放在变量上面,并不能出现完整的注释内容哦。
    请按照规范写。
    init
    init
    Sep 26, 2018
    134
    讲真 我觉得真的是挺好的
    wobuhuicode
    wobuhuicode
    Sep 26, 2018
    135
    JSer。 做了一段时间 OC 之后,注释少了,但是函数名长了
    dychenyi
    dychenyi
    Sep 26, 2018
    136
    doxgen 生成一份详细开发说明书就是这么写的。 好多开源类的文档就是这么来的
    YzSama
    YzSama
    Sep 26, 2018 via iPhone
    137
    你排下版, 比如 注释文字对齐
    ashe
    ashe
    Sep 26, 2018❤️4
    138
    让各位见笑了。这幅图的出处是我写的代码。
    我不但有写注释的习惯,还有写文档的怪癖。
    除了这个注释,我还配了一个上万字的文档..........
    图略大。http://alonesuperman.com/statics/imgs/doc.png
    xiaoyang7545
    xiaoyang7545
    Sep 26, 2018
    139
    我觉得没问题,主要注释没有干扰到代码的阅读。
    jasonyang9
    jasonyang9
    Sep 26, 2018
    140
    注释和代码对不上,一定以及肯定会被打死
    nikymaco
    nikymaco
    Sep 26, 2018
    141
    这个注释写得挺好。把参数来意,方法逻辑在规范的地方写上了特别有助于团队开发。如果是写过多注释在方法体内就变成除臭剂了,这样就不太好了,代码阅读起来费劲。不过这一切都是团队一起规范起来才行,方法体有变更就要即时更新注释,特别是有些家伙改了你的东西没有即时更新,那就操蛋了,哈哈。
    swim2sun
    swim2sun
    Sep 26, 2018❤️1
    142
    建议不嫌注释多的看看《 clean code 》。
    注释维护起来是比较麻烦的,一旦代码改了注释没同步更改,这不会影响编译和测试,但隐患就产生了,错误的注释还不如没有注释。
    合适的变量名、方法名远比注释有用
    young7657
    young7657
    Sep 26, 2018
    143
    把注释当成文档来写也不太好吧
    fundebug
    fundebug
    OP
    Sep 26, 2018
    144
    @swim2sun 《 clean code 》果然精辟,变量名和方法名确实得花点心思,不能随便取!
    zky001
    zky001
    Sep 27, 2018
    145
    能说清楚就好啦!
    1  2  
    ❮ ❯
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   2106 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 96ms · UTC 13:49 · PVG 21:49 · LAX 05:49 · JFK 08:49
    ♥ Do have faith in what you're doing.