接手一个项目,看别人的代码好痛苦,注释都没有 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
UtopiaCHN
V2EX    程序员

接手一个项目,看别人的代码好痛苦,注释都没有

  •  
  •   UtopiaCHN 2016-01-11 14:00:29 +08:00 9081 次点击
    这是一个创建于 3574 天前的主题,其中的信息可能已经有所发展或是发生改变。
    39 条回复    2016-02-02 11:54:11 +08:00
    yurivvvvv
        1
    yurivvvvv  
       2016-01-11 14:14:13 +08:00
    好的知道了。
    tomwei7
        2
    tomwei7  
       2016-01-11 14:38:55 +08:00
    axknightroad
        3
    axknightroad  
       2016-01-11 14:44:03 +08:00
    知道了,你可以继续去看代码了
    dark456852
        4
    dark456852  
       2016-01-11 15:37:14 +08:00
    知道了,就这样
    xylophone21
        5
    xylophone21  
       2016-01-11 15:41:38 +08:00
    你确定注释不属于躺枪?
    tempuseraccount
        6
    tempuseraccount  
       2016-01-11 15:44:58 +08:00
    习惯了就好了。
    无注释无文档,项目经手多人,代码风格迥异,各种莫名其妙的 hack 。这是常态
    wingyiu
        7
    wingyiu  
       2016-01-11 16:29:43 +08:00
    好代码不需要注释
    Anybfans
        8
    Anybfans  
       2016-01-11 16:31:37 +08:00
    不知道这个算不算有注释的代码。。
    zzn
        9
    zzn  
       2016-01-11 16:34:49 +08:00
    有的时候有注释还不如没注释
    evakiss
        10
    evakiss  
       2016-01-11 17:01:50 +08:00 via Android
    我一般写 01 机器码来写程序,为了防止别人看不懂,都是附加了 Python 作为注释的,遇到小白还要双斜杠 PHP 代码作为注释,好累
    qurioust
        11
    qurioust  
       2016-01-11 17:16:31 +08:00
    @Anybfans 是 django 么
    wangyongbo
        12
    wangyongbo  
       2016-01-11 17:24:50 +08:00
    @qurioust 据我目测,是 django 。
    wangyongbo
        13
    wangyongbo  
       2016-01-11 17:26:28 +08:00
    我觉得如果看没有注释的代码感觉很痛苦,是因为代码写的不够好。

    最近,我一边看 tastypie 的代码,一边写应用, 发现人家写的代码,比文档还要容易懂。

    差距太大了。
    Anybfans
        14
    Anybfans  
       2016-01-11 17:27:03 +08:00
    @qurioust
    @wangyongbo 嗯。。是 django.
    算是新人啊。不知道这样注释合适不合适。
    elgoog1970
        15
    elgoog1970  
       2016-01-11 18:37:14 +08:00
    好的,我以后尽量加上注释!!!!
    stdying
        16
    stdying  
       2016-01-11 19:08:06 +08:00
    多少行
    cxbig
        17
    cxbig  
       2016-01-11 19:10:58 +08:00
    看到哪把注释补充道哪,这么好的锻炼机会还不赶快抓住
    pagxir
        18
    pagxir  
       2016-01-11 19:16:44 +08:00 via iPad   1
    一般我写注释是用来解释为什么这么干。至于干了什么,除非确实很难看懂,否则不写。
    m1911star
        19
    m1911star  
       2016-01-11 19:28:29 +08:00
    @Anybfans 6666,心疼
    void1900
        20
    void1900  
       2016-01-11 19:44:03 +08:00
    其实注释没多大卵用
    iiilii
        21
    iiilii  
       2016-01-11 19:45:37 +08:00
    好的代码会自注释的
    doublepeng
        22
    doublepeng  
       2016-01-11 19:55:29 +08:00
    最近同接手项目,没办法,从日常维护开始看原理。 Python 项目,看懂很快的。
    twoyuan
        23
    twoyuan  
       2016-01-11 21:35:42 +08:00
    老段子,程序员最讨厌的四件事:
    1. 写文档
    2. 写注释
    3. 看没有文档的项目
    4. 看没有注释的代码
    louk78
        24
    louk78  
       2016-01-12 08:43:05 +08:00
    老段子,程序员最讨厌的四件事:
    1. 写文档
    2. 写注释
    3. 看没有文档的项目
    4. 看没有注释的代码
    sprinng
        25
    sprinng  
       2016-01-12 09:15:11 +08:00
    一样一样的
    pyengwoei
        26
    pyengwoei  
       2016-01-12 09:27:42 +08:00
    看这个 哈哈 t/245653#reply55
    Immortal
        27
    Immortal  
       2016-01-12 10:00:17 +08:00
    @Anybfans 是 sublime 吧?请问字体和主题是?
    Scoield
        28
    Scoield  
       2016-01-12 10:23:31 +08:00
    其实我也不喜欢注释,命名好一点一看就懂……
    Anybfans
        29
    Anybfans  
       2016-01-12 10:24:53 +08:00
    @Immortal 是 sublime
    主题是 meterial

    "color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme",
    "theme": "Material-Theme.sublime-theme",
    "font_face": "Consolas",
    Anybfans
        30
    Anybfans  
       2016-01-12 10:25:23 +08:00
    wangdonny
        31
    wangdonny  
       2016-01-12 10:43:36 +08:00
    最近在看 clean code ,豁然开朗,好代码是自注释的,有了注释,反而容易让代码变臃肿不易理解
    shajiquan
        32
    shajiquan  
       2016-01-12 13:27:35 +08:00
    @Anybfans 好注释……+10010
    roys
        33
    roys  
       2016-01-12 14:26:20 +08:00
    就算有注释一样痛苦,兄弟顶住
    nikola
        34
    nikola  
       2016-01-12 16:57:44 +08:00
    @Anybfans 注释已经很详尽了
    111111111111
        35
    111111111111  
       2016-01-12 21:00:32 +08:00 via Android
    @Anybfans
    for 循环是不是可以精简一些?
    lsxploc
        36
    lsxploc  
       2016-01-12 23:21:35 +08:00
    代码结构清晰的话,还需要注释吗
    atubo
        37
    atubo  
       2016-01-13 07:59:41 +08:00
    每一个程序员接手代码的时候都抱怨没文档,没注释,但自己写的代码,也不写注释,也不写文档。
    aitaii
        38
    aitaii  
       2016-01-13 09:03:01 +08:00
    @atubo 233
    Tuisku
        39
    Tuisku  
       2016-02-02 11:54:11 +08:00
    : ) 所以我实习离职的时候不小心把我写的 js 加密了一下 后台变量改了一下 Int32 _;String __;String _0__;
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     3367 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 27ms UTC 00:08 PVG 08:08 LAX 17:08 JFK 20:08
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86