程序员最讨厌的两件事,1:自己写注释,2:别人不写注释
⭐发布日期:2024年10月10日 | 来源:新民晚报
【2024新奥天天开好彩大全】 |
【香港6合今晚开奖结果+开奖记录】 |
【澳门天天开彩好2024资料】 | 【2024澳门天天开彩大全】 | 【正版2023澳门天天开好彩大全】 | 【香港开彩期开奖结果记录】 | 【澳门六开彩开奖结果历史查询】 | 【2024澳门天天彩免费】 | 【澳门天天好好彩特】 | 【新澳天天开奖资料大全最新54期图片下载】 |
【新澳门4949最新开奖记录】 | 【2023新澳门天天开好彩】 | 【最准一码一肖100%精准,管家婆】 | 【新澳门今晚开奖结果+开奖】 | 【新澳门最新快资料】 | 【新澳门天天彩2024年全年资料】 | 【2024天天彩资料大全免费】 | 【新澳今天最新资料2024年开奖】 |
当了这么多年程序员,才懂得细节是评价一名优秀程序员的重要参考标准。
为什么这样说呢?来先看一段代码,代码层面加了很清晰的注释来解释这段代码为什么这么写,使看的人引发思考,便于理解,不知不觉间会产生一种亲切感有木有~
注释的分类:
1.单行注释
以//双斜杠后面加上要描述的注释信息
这是最简单的注释方式了,特别是在定义变量时,尤其重要,当程序代码块较长时;经常会出现一些相似命名的变量,这时候为不同的变量加以说明会起到非常重要的作用。
2.多行注释
/*
*
*/
类似于这种以斜杠后跟一个星号组成的代码块为多行注释,一般用于描述代码块中一段复杂的业务逻辑说明,或对代码的解释。
多行注释相比较而言比较鸡肋,用的地方并不多。
3.文档注释(最重要的注释了)
我们阅读源码时,经常会看到大块大块的注释,一般用于类,方法上对作者,版本,功能,出入参进行一个解释,当别的代码引用时,就可以看到代码清晰的功能解释和出入参。
这种注释可以用于javadoc生成api文档,理解就好,一般用不到。
重点来了,在日常开发中最苦恼的事是什么呢?同事离职代码交接,大段大段的一个注释都没有,完全找不到切入点,这种苦恼的心情,真的是叫天天不应,叫地地不灵啊。
新员工的感触一定是最深的。
大家来感触一下,如果不会点英文,感觉在读天书。
那么道理都懂,可为什么还是过不好这一生?拿我自己的感觉,我自己在开发时感觉自己写的代码都很简单,思路如泉涌,需要写注释吗?还有其实内心深入有一种排斥感,为什么会这样呢?可能是有以下几点原因:
1.写一行注释就感觉是在浪费时间
2.这么见名知义的代码,根本不需要写
3.得过且过,自己就在这里待一年多,大不了就走呗
4.这样看起来应该很牛X
好啦,本着为人为已,百利而无一害的原则,劝新入行的程序员一定要认真地写好注释。一本书上曾提到注释的量,约占整个程序的20%~50%,这可是清华大学出版的,《Java从入门到精通里》,可见注释的重要性了。
持续打造精品、优质、计算机专业知识,想听什么就留言吧,咱们明天见。
【2024澳门天天开好彩大全免费】 【新澳天天开奖资料大全最新】 |
【2024年天天开好彩资料】 【新澳天天开奖资料大全最新54期】 |
【2024澳门天天开好彩大全53期】 【澳门天天开彩期期精准】 |
【2024全年资料免费大全】 【新澳天天开奖资料大全】 |
【澳门内部最精准免费资料】 【2024澳门天天开好彩大全】 |
【2024年新奥门天天开彩免费资料】 【新澳2024今晚开奖资料】 【新澳门正牌挂牌之全篇】 |
发表评论
张会
9秒前:当了这么多年程序员,才懂得细节是评价一名优秀程序员的重要参考标准。
IP:77.71.4.*
赤坂ルナ
4秒前:同事离职代码交接,大段大段的一个注释都没有,完全找不到切入点,这种苦恼的心情,真的是叫天天不应,叫地地不灵啊。
IP:17.24.9.*
张复
5秒前:写一行注释就感觉是在浪费时间2.
IP:32.14.8.*