接手一个项目,看别人的代码好痛苦,注释都没有 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
请不要在回答技术问题时复制粘贴 AI 生成的内容
UtopiaCHN

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

  •  
  •   UtopiaCHN Jan 11, 2016 9446 views
    This topic created in 3759 days ago, the information mentioned may be changed or developed.
    39 replies    2016-02-02 11:54:11 +08:00
    yurivvvvv
        1
    yurivvvvv  
       Jan 11, 2016
    好的知道了。
    tomwei7
        2
    tomwei7  
       Jan 11, 2016
    axknightroad
        3
    axknightroad  
       Jan 11, 2016
    知道了,你可以继续去看代码了
    dark456852
        4
    dark456852  
       Jan 11, 2016
    知道了,就这样
    xylophone21
        5
    xylophone21  
       Jan 11, 2016
    你确定注释不属于躺枪?
    tempuseraccount
        6
    tempuseraccount  
       Jan 11, 2016
    习惯了就好了。
    无注释无文档,项目经手多人,代码风格迥异,各种莫名其妙的 hack 。这是常态
    wingyiu
        7
    wingyiu  
       Jan 11, 2016
    好代码不需要注释
    CodeDrift
        8
    CodeDrift  
       Jan 11, 2016
    不知道这个算不算有注释的代码。。
    zzn
        9
    zzn  
       Jan 11, 2016
    有的时候有注释还不如没注释
    evakiss
        10
    evakiss  
       Jan 11, 2016 via Android
    我一般写 01 机器码来写程序,为了防止别人看不懂,都是附加了 Python 作为注释的,遇到小白还要双斜杠 PHP 代码作为注释,好累
    qurioust
        11
    qurioust  
       Jan 11, 2016
    @Anybfans 是 django 么
    wangyongbo
        12
    wangyongbo  
       Jan 11, 2016
    @qurioust 据我目测,是 django 。
    wangyongbo
        13
    wangyongbo  
       Jan 11, 2016
    我觉得如果看没有注释的代码感觉很痛苦,是因为代码写的不够好。

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

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

    "color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme",
    "theme": "Material-Theme.sublime-theme",
    "font_face": "Consolas",
    CodeDrift
        30
    CodeDrift  
       Jan 12, 2016
    wangdonny
        31
    wangdonny  
       Jan 12, 2016
    最近在看 clean code ,豁然开朗,好代码是自注释的,有了注释,反而容易让代码变臃肿不易理解
    shajiquan
        32
    shajiquan  
       Jan 12, 2016
    @Anybfans 好注释……+10010
    roys
        33
    roys  
       Jan 12, 2016
    就算有注释一样痛苦,兄弟顶住
    nikola
        34
    nikola  
       Jan 12, 2016
    @Anybfans 注释已经很详尽了
    111111111111
        35
    111111111111  
       Jan 12, 2016 via Android
    @Anybfans
    for 循环是不是可以精简一些?
    lsxploc
        36
    lsxploc  
       Jan 12, 2016
    代码结构清晰的话,还需要注释吗
    atubo
        37
    atubo  
       Jan 13, 2016
    每一个程序员接手代码的时候都抱怨没文档,没注释,但自己写的代码,也不写注释,也不写文档。
    aitaii
        38
    aitaii  
       Jan 13, 2016
    @atubo 233
    Tuisku
        39
    Tuisku  
       Feb 2, 2016
    : ) 所以我实习离职的时候不小心把我写的 js 加密了一下 后台变量改了一下 Int32 _;String __;String _0__;
    About     Help     Advertise     Blog     API     FAQ     Solana     3139 Online   Highest 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 159ms UTC 14:41 PVG 22:41 LAX 07:41 JFK 10:41
    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