浏览 3187 次
锁定老帖子 主题:看代码看得生气
精华帖 (3) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
|
|
---|---|
作者 | 正文 |
发表时间:2011-07-25
读了一些公共类,功力不足,看得异常辛苦。。。 前辈们,能好好写些注释么。代码不光用来运行,也要用来看的。 别和我扯什么好的代码不需要注释,只需要命名方式和结构清晰就能说明一切。ADOBE那么好的风格,API也不见少了一行注释啊,ASDOC是用来扯蛋的么。写注释是要去解释代码么,根本不是,是要写代码无法表现出来的逻辑,比如这几句代码的目的、这个方法的使用环境及返回结果。这样子,我在阅读代码就能忽略具体的函数细节,只关注我想看的内容。而不是一行行地读。。。。读着读着就发现某个变量不知道是干啥的,声明处也不解释,就两个驼峰单词,我能理解么,这不坑爹么。。。我慢慢看也能看懂,可是写上注释会死人么。 还有人说,写了注释,以后改代码,还要同步改注释。。。我只能说,不同步改注释的人,是个不负责任的人。。。代码都改了,注释改一下会累死么。 那些完美极客们,不要认为所有人都能用命名空间和设计风格就能让代码自己表明自己的目的。不是所有人都这么NB,不是所有阅读者都能从简单的几个单词就猜出这变量在干什么,他们没有那么多时间。他们经常是出了BUG的时候,着急得不行,却要看一个个毫无注释的类代码,这让他们情何以堪!!! 同意我的朋友们,请认真写你的注释,不用行行写,ASDOC就够了。变量的用处,核心算法的代码化,请写上一点。一句话,请以代码阅读者和查BUG者的心态去写注释,因为这个人在将来可能就是你自己!!! 声明:ITeye文章版权属于作者,受法律保护。没有作者书面许可不得转载。
推荐链接
|
|
返回顶楼 | |
发表时间:2011-07-25
最后修改:2011-07-25
淡定淡定,我已经习惯看一行注释也没有的代码了
你现在的语言已经非常网络化了,有90后的风格了,哈哈 另外,给你“加精”了 ![]() |
|
返回顶楼 | |
发表时间:2011-07-26
cwfmaker 写道 淡定淡定,我已经习惯看一行注释也没有的代码了
你现在的语言已经非常网络化了,有90后的风格了,哈哈 另外,给你“加精”了 ![]() 唉。。。肿么会这样,全世界那么多无注释的代码么 |
|
返回顶楼 | |
发表时间:2011-07-26
如果统计产量的时候注释也算代码行数,哪怕打个对折,我就写
|
|
返回顶楼 | |
发表时间:2011-07-26
强强爱妍妍 写道 如果统计产量的时候注释也算代码行数,哪怕打个对折,我就写
看来您还是体会不到我读代码时候的痛苦啊 其实我上家公司统计代码是算注释的,结果注释满天飞。。。。唉。。。这不是办法啊 |
|
返回顶楼 | |
发表时间:2011-07-26
注释?
如果 XXXXXXXXX//注释1 YYYYYYYYY//注释2 那么 function 注释1(){ XXXXXXXXXX } function 注释2(){ YYYYYYYYYY } |
|
返回顶楼 | |
发表时间:2011-07-27
gtssgtss 写道 注释?
如果 XXXXXXXXX//注释1 YYYYYYYYY//注释2 那么 function 注释1(){ XXXXXXXXXX } function 注释2(){ YYYYYYYYYY } 我文中已经解释我希望注释是什么样子的了: API也不见少了一行注释啊,ASDOC是用来扯蛋的么。写注释是要去解释代码么,根本不是,是要写代码无法表现出来的逻辑,比如这几句代码的目的、这个方法的使用环境及返回结果。这样子,我在阅读代码就能忽略具体的函数细节,只关注我想看的内容。而不是一行行地读。。。。 |
|
返回顶楼 | |