V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
UtopiaCHN
V2EX  ›  程序员

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

  •  
  •   UtopiaCHN · 2016-01-11 14:00:29 +08:00 · 8404 次点击
    这是一个创建于 3029 天前的主题,其中的信息可能已经有所发展或是发生改变。
    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
    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   ·   我们的愿景   ·   实用小工具   ·   907 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 28ms · UTC 22:23 · PVG 06:23 · LAX 15:23 · JFK 18:23
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.