命名规范与注释哪个更重要? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
wtl
V2EX    随想

命名规范与注释哪个更重要?

  •  
  •   wtl 2011-08-07 22:32:07 +08:00 5987 次点击
    这是一个创建于 5236 天前的主题,其中的信息可能已经有所发展或是发生改变。
    吐槽一下 窃以注释没空可以不写 命名一定要规范
    不少人写的代码很让人受不了 随意简写变量名及方法名
    看代码非要时不时去看注释 又恶心又累
    多打两个字 字本身即是注释
    何必呢?
    12 条回复    1970-01-01 08:00:00 +08:00
    dongsheng
        1
    dongsheng  
       2011-08-07 22:38:10 +08:00
    命名是件纠结的事,好的命名是高质量代码的重要部分
    fluke
        2
    fluke  
       2011-08-07 22:41:52 +08:00
    两个都重要,好的命名可以节省注释。
    Harry
        3
    Harry  
       2011-08-07 23:07:16 +08:00
    更重要的是命名。一个好的命名本身就是注释,而且是好的注释。
    zythum
        4
    zythum  
       2011-08-07 23:12:39 +08:00
    只要能让下个人可以方便得看懂就好。
    glume
        5
    glume  
       2011-08-23 00:25:19 +08:00
    两手抓,两手都要硬。
    pinepara
        6
    pinepara  
       2011-08-23 00:40:31 +08:00
    好的代码应该是自注释的。
    不涉及到复杂算法的地方应该让代码不依赖注释也完全可读。
    wtl
        7
    wtl  
    OP
       2011-08-23 15:45:26 +08:00
    @pinepara 深以为然!
    tox
        8
    tox  
       2011-08-23 16:14:14 +08:00
    一直注意命名问题,现在注释很少写,以后要改。
    项目紧的话,有时命名也很坑。
    orzzzzz
        9
    orzzzzz  
       2011-08-23 17:53:29 +08:00
    两码事,都很重要...不能相互替代,只能说相互增益.
    命名可以说明的注释就不是需要的注释....但并不是说,只要有好的命名了,就不需要注释了.
    --
    回头补注释的机会很微....当然,你会想,重构的时候再....咳咳...
    dogFish
        10
    dogFish  
       2011-08-23 17:58:05 +08:00
    webkit的代码里就很少有注释, 因为变量函数命名清晰易懂
    myrual
        11
    myrual  
       2011-08-23 18:02:58 +08:00
    能够自解释的代码会好很多。
    但是自解释的效果和文字表达能力有关。
    同时自解释的效果也和程序工作原理有关,如果基于某个复杂的数据结构或者算法,自解释也没意义。
    如果代码设计是按着业务流程的来设计的话,那么维护的难度会简单很多。
    如果是按着内部如何实现的方法来设计的话,那么维护的难度会大一点,毕竟维护者要理解技术上是怎么实现的,并且理解业务和技术实现如何连接的
    obiwong
        12
    obiwong  
       2011-08-28 21:48:51 +08:00
    减法和加法哪个更重要?
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2999 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 31ms UTC 13:38 PVG 21:38 LAX 05:38 JFK 08:38
    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