从“穷逼VIP”论注释规范,你见过哪些奇葩的注释?

313 阅读7分钟
原文链接: click.aliyun.com

1305005110203438

ecs服务器网站访问速度慢具体都有有什么原因?

夏之冰雪

1.你觉得代码规范化/注释规范化,重要吗,有什么好的规范建议。
很重要,可以让这个team组风格一致,大家互相协作更高效,编码也更清爽。
建议也有很多:
a. 编辑器加入代码规范检测插件,很多编辑器都有。
b. 公司要有代码规范指南,或者使用开源的,比如阿里java代码规范。
c. 使用代码质量检测工具,对所有提交的代码,进行检测,比如sonar平台。
d. 新人培训,加入代码和注释规范的环节。

2.在工作中遇到过类似的奇葩注释吗,和大家分享下吧。
代码明明是自己写的,而注释作者一处,却写别人名字。

3.和大家分享下你写代码的技巧可好。
业务解耦,清爽的业务代码和丰富的注释相比,前者可读性更强。
每次为了bug修改代码,尽量加上注释予以说明。
不写没用的代码,避免写大量解释性的代码。
函数命名,变量命名,有时候就能很好表达是什么、做什么了。

4.你写没写过什么奇葩代码,说说。
之前,公司一同事接手一个图像生成的代码,很恼火。
由于生成的图像涉及位置计算、深度计算之类的,代码里到处都是数字。
最关键,这些公式里的数字,有的还是7.33这种,鬼知道是怎么来的。
然后,发现了好几处注释:
// this is magic number

以上代码,就是我写的。
后来那人问我,我说我就是不停地调整数字,然后看效果,再调数字,所以是magic number。

海洋的云

1.你觉得代码规范化/注释规范化,重要吗,有什么好的规范建议。
很重要。代码规范化除了是程序员自身的代码素质体现外,在进行团队合作时,可以避免很多不必要的玛法。而注释规范化对于个人而言,在回顾代码含义或者代码检查时,方便阅读,尤其是较早之前写过的代码。对于进行代码交接时,也方便后面的同事进行维护。最近发现阿里巴巴Java开发手册不错,可以参考下。
2.在工作中遇到过类似的奇葩注释吗,和大家分享下吧。
听说过有程序员在代码注释里表白的,应该不算是奇葩注释吧~~
3.和大家分享下你写代码的技巧可好。
看过阿里巴巴Java开发手册,里面的内容不错,可以先学习下,再就是在看别人写的代码时,也会学习其中的优点。
其实最开始把代码写规范,把注释写好还是挺困难的事情,毕竟和自己的代码习惯不是很一致,而且有时候会感觉浪费时间,但是真的坚持下来的话,后期收获还是很大的,好的编码习惯,慢慢适应就好了。
4.你写没写过什么奇葩代码,说说。
谁没个曾经啊,不说,O(∩_∩)O哈哈~

公仔、公仔、公仔,谢谢~

1859911358039699

网站建设不懂

浮生递归

1.你觉得代码规范化/注释规范化,重要吗,有什么好的规范建议。
就跟写行政文书一样吧,言简意赅,但是这样少了点乐趣,让码字更枯燥了。加点调料感觉也挺好啊。轻松一下,工作更有效率。

2.在工作中遇到过类似的奇葩注释吗,和大家分享下吧。
最奇葩的代码就是像文中的天才型程序员一样,没有注释!好吧,其实我也没有写注释的习惯。所以经常回头改自己几年前的程序时,因为本身就命名不规范,导致各种看不懂,真是各种坑自己。现在学乖了,宁可多打几个字,也要把命名给写清楚了。为了不用写注释。。。

3.和大家分享下你写代码的技巧可好。
坑多了,就感觉规范还是有必要的。具体的话,就看下阿里巴巴Java规范吧。

4.你写没写过什么奇葩代码,说说。
写过一次,当时只想着快,所有的类名、方法名称都只用了一个字母,这样写起来确实速度快了很多。各种s\f\a这样的。还不写注释。最后就自己也看不懂是什么的缩写了,尴尬了。

1833611475125024

与我无关

千千文艺

不怕一错,就怕再错,更怕一错到底。只有自己装逼,但是永远欺骗的还是自己。因为比你懂的人永远存在

1463211475813082

这款软件很不错

1587411447575546

看不懂,,,,

千千文艺

云计算服务器能否升级为个人分体云服务器

aoteman675

1.你觉得代码规范化/注释规范化,重要吗,有什么好的规范建议。
这个得看项目是一个人开发还是团队开发,如果是团队开发,注释还是很有必要啦,一个人只要自己看得懂就行了,掌握核心代码,哈哈哈,老板不会炒鱿鱼
2.在工作中遇到过类似的奇葩注释吗,和大家分享下吧。
注释全英文,看不懂
3.和大家分享下你写代码的技巧可好。
写代码讲究的是一气呵成,不能被打断。思路一段就得重写,除非有程序员鼓励师。
4.你写没写过什么奇葩代码,说说。
奇葩代码就是一个星期后自己都看不懂,命名脑子抽筋中文混合式开发

1077211435242550

深表同感~

1293111435187199

我也只是路过,不太懂啊

1305005110203438

什么鬼?

隔夜的果酱

这个地方有bug,我要辞职了,就不动了。

1940411428887752

不懂代码

aijaw

程序员认真做注释还真不多,有些程序改了注释不改,有些干脆没有!

尼古拉斯雷

1.你觉得代码规范化/注释规范化,重要吗,有什么好的规范建议。

重要,代码的质量和可读性非常的重要。
质量好的代码,看起来很舒服。
好的注释让人好理解这个东西是干嘛的。

多读书,多看报,少吃零食多睡觉。
不是,有Java代码规约插件嘛,还有代码规范的文档,都不错啊,支持看看。

2.在工作中遇到过类似的奇葩注释吗,和大家分享下吧。

最服的就是这一段代码

<a href="javascript:alert('清除成功')" >清除缓存</a>


6cf609126c79a3f70158afddc7e1e33c_r
3.和大家分享下你写代码的技巧可好。

经常看别人写的代码,再与自己比较就知道这个人是不是规范的代码。
还有查看文档和通过插件来改正自己。

4.你写没写过什么奇葩代码,说说。

初学java的时候,类名是中文的。Σ(|||▽||| )
是的,就是中文的。
后来知道这样写是不对的,然后就改正了。

1994095454615509

呵呵,只想笑笑