美文网首页
那些令人喷饭的代码注释,最后一个让我笑出了声!

那些令人喷饭的代码注释,最后一个让我笑出了声!

作者: 分不清java | 来源:发表于2018-11-17 14:54 被阅读14次

真事儿,在公司的时候,曾经有一位技术很牛的前辈,在代码中的注释上写了一句“测个毛”,这不是重点,重点是他把这句话粘到了弹出框的文字上,自己测试一下代码逻辑,就随意打了这三个字,结果提交代码忘记修改了,后来在bug系统发现了这个bug,并得到了测试部老大的问候。

如果有想学习java的程序员,可以来我们的java学习群:8184,64711免费送java的视频教程噢!小编是一名5年java开发经验的全栈工程师,整理了一份适合18年学习的java干货,送给每一位想学的小伙伴,欢迎大家一起学习哦。

个人观点,只是经验之谈,欢迎来喷 !

1、在类级别,方法级别上最好加上注释。

特别是那些逻辑复杂的,难以用一句话描述清楚的内容,最好加上注释,讲清楚这个类,或这个方法是用来干嘛的,有什么需要注意的地方。这个注释很重要,特别是这些代码还要被其他人使用的时候,加上说明会方便很多。

2、在某些容易留坑的地方,最好加上注释。

这种地方很多时候是因为图省事,或者没时间等原因,只能暂时这么做,但是需要提醒使用者注意。或者怀疑队友水平没那么高,理解不了你的代码,某天来修改代码并且容易改错。或者是因为这段代码『特立独行』,不是按照常规方式,你自己在这里耍了小聪明,或者用了自己设计的一些技巧性的东西,怕别人看不懂。

3、涉及到业务逻辑的代码,比如某些字段需要加说明,之类的。

有些业务的东西,确实不是一两句代码就能扯清楚的,这种东西,加个注释就好了。

4、因为修复某个bug而加进去的代码。

改bug,特别是改别人的bug的时候,如果不是进行大规模的重构,而是往里面加小段代码打补丁的时候,最好加上注释,否则这段代码很奇怪,并且容易看不懂。记住最好留上你的名字,不然后人看这个代码都不知道该去骂谁,hiahiahia~。

相关文章

  • 那些令人喷饭的代码注释,最后一个让我笑出了声!

    真事儿,在公司的时候,曾经有一位技术很牛的前辈,在代码中的注释上写了一句“测个毛”,这不是重点,重点是他把这句话粘...

  • iOS 注释

    1、规范的注释让代码更好看 2、规范的注释让代码更实用 注释(单行注释) /* <##> */ 注释(预编译注释...

  • Xcode 插件的使用

    1.代码注释(单行注释,多行注释,方法注释,方法集注释)2.使用Xcode自定义代码块 第一个问题:代码注释插件 ...

  • 趣图:这代码谁写的,太可怕了!

    扩展阅读 代码整洁之道|最佳实践小结 笑哭丨谁的代码注释我都不服,就服你的! 公众号:javafirst

  • WKWebView的封装使用

    概述 今天又整理出了一个WKWebView的封装工具,并且将代码内部加入了较详细的代码注释 WX20190719-...

  • OC代码规范3

    注释 读没有注释代码的痛苦你我都体会过,好的注释不仅能让人轻松读懂你的程序,还能提升代码的逼格。注意注释是为了让别...

  • 2018-07-04 代码规范记录

    注释 不要给不好的名字加注释,一个好的名字比好的注释更重要 不要“拐杖注释”,好代码 > 坏代码 + 好注释 在文...

  • Python 代码注释格式

    Python代码 注释 # 注释内容 # 订单模块 HTML代码 注释

  • 趣图:只改了一行代码……

    我擦,出什么事了? 我只是改了一行代码而已…… ↓↓↓ 扩展阅读 如何处理前任程序员留下的代码 笑哭丨谁的代码注释...

  • Spring 依赖注入(注解、Bean、Resource)

    Annotation(注解) 观察上面代码,发现多出了一个语法@service 注解是Java推出的一种注释机制,...

网友评论

      本文标题:那些令人喷饭的代码注释,最后一个让我笑出了声!

      本文链接:https://www.haomeiwen.com/subject/ndzbfqtx.html