程序员令人笑喷的代码注释,测试部:下班留下来谈谈人生!
2018-03-28 11:45
711 查看
小编先说一件真事,以前在公司的时候,有一位技术非常牛逼的前辈,在代码注释中写了“说了你也听不懂!垃圾”,这不是重点,重点是他下意识的把这句话复制到了弹框提示的文字中,用来测试一个代码的逻辑性,后来忘了删除。代码也提交到了测试部,巧的是在bug系统发现了这个bug,bug弹出了“说了你也听不懂!垃圾”,最后被测试部的大佬邀请喝公办茶。
个人观点,只是经验之谈,欢迎来喷 !1、在类级别,方法级别上最好加上注释。特别是那些逻辑复杂的,难以用一句话描述清楚的内容,最好加上注释。这个注释很重要,特别是这些代码还要被其他人使用的时候,加上说明会方便很多。2、在某些容易留坑的地方,最好加上注释。这种地方很多时候是因为图省事,或者没时间等原因,只能暂时这么做,但是需要提醒使用者注意。或者怀疑队友水平没那么高,理解不了你的代码,某天来修改代码并且容易改错。或者是因为这段代码『特立独行』,不是按照常规方式,你自己在这里耍了小聪明,或者用了自己设计的一些技巧性的东西,怕别人看不懂。3、涉及到业务逻辑的代码,比如某些字段需要加说明,之类的。有些业务的东西,确实不是一两句代码就能扯清楚的,这种东西,加个注释就好了。4、因为修复某个bug而加进去的代码。改bug,特别是改别人的bug的时候,如果不是进行大规模的重构,而是往里面加小段代码打补丁的时候,最好加上注释,否则这段代码很奇怪,并且容易看不懂。记住最好留上你的名字,不然后人看这个代码都不知道该去骂谁,在这里我推荐下我自己的web前端裙了:618522268 ,不管你是小白还是大牛,小编我都挺欢迎,不定期分享干货,包括我自己整理的一份最新web前端网页制作资料和零基础入门教程!,欢迎初学和进阶中的小伙伴。写在最后很多人都知道我是学全栈的,都天真的以为我有全套的前端、网页制作等视频学习资料。我想说你们是对的,我有前端的全套视频资料。
个人观点,只是经验之谈,欢迎来喷 !1、在类级别,方法级别上最好加上注释。特别是那些逻辑复杂的,难以用一句话描述清楚的内容,最好加上注释。这个注释很重要,特别是这些代码还要被其他人使用的时候,加上说明会方便很多。2、在某些容易留坑的地方,最好加上注释。这种地方很多时候是因为图省事,或者没时间等原因,只能暂时这么做,但是需要提醒使用者注意。或者怀疑队友水平没那么高,理解不了你的代码,某天来修改代码并且容易改错。或者是因为这段代码『特立独行』,不是按照常规方式,你自己在这里耍了小聪明,或者用了自己设计的一些技巧性的东西,怕别人看不懂。3、涉及到业务逻辑的代码,比如某些字段需要加说明,之类的。有些业务的东西,确实不是一两句代码就能扯清楚的,这种东西,加个注释就好了。4、因为修复某个bug而加进去的代码。改bug,特别是改别人的bug的时候,如果不是进行大规模的重构,而是往里面加小段代码打补丁的时候,最好加上注释,否则这段代码很奇怪,并且容易看不懂。记住最好留上你的名字,不然后人看这个代码都不知道该去骂谁,在这里我推荐下我自己的web前端裙了:618522268 ,不管你是小白还是大牛,小编我都挺欢迎,不定期分享干货,包括我自己整理的一份最新web前端网页制作资料和零基础入门教程!,欢迎初学和进阶中的小伙伴。写在最后很多人都知道我是学全栈的,都天真的以为我有全套的前端、网页制作等视频学习资料。我想说你们是对的,我有前端的全套视频资料。
相关文章推荐
- “穷X”事件程序员致歉:以后老实写代码,正紧写注释
- 史上最无聊的程序员是怎样注释代码的
- 谈谈自己对随机森林(Random Forest)的一点理解以及代码注释~
- 虾米音乐代码注释惊现 “穷逼 vip”,程序员要出来接锅了
- 程序员应该避免的5种代码注释
- 虾米音乐mac端应用代码注释惊现“穷逼vip”,是程序员干的
- 虾米音乐代码注释惊现“穷逼vip”程序员又背锅了
- 趣味横生的程序员搞怪代码注释
- 程序员又背锅了!虾米音乐代码注释惊现“穷逼vip”
- 逻辑思维 代码人生 程序员必看的十大经典电影~!
- 程序员应该避免的 5 种代码注释
- 程序员的代码人生
- 程序人生--伟大的程序员只修改代码
- 黑马程序员_UDP和TCP简单的通信代码和注释学习笔记
- 我也谈谈程序员的人生规划
- 11个程序员幽默代码注释
- 史上最无聊的程序员是怎样注释代码的
- 逻辑思维 代码人生 程序员不容错过的十大经典电影~!
- 《C++精英内参之程序员高效指南》-11常用的读代码方法除了写注释的,还有其他方法
- 虾米音乐代码注释惊现 “穷逼 vip”,程序员要出来接锅了