java代码注释中的5要与3不要是什么
导读:本文共1742字符,通常情况下阅读需要6分钟。同时您也可以点击右侧朗读,来听本文内容。按键盘←(左) →(右) 方向键可以翻页。
摘要: 代码注释,可以说是比代码本身更重要。这里有一些方法可以确保你写在代码中的注释是友好的:不要重复阅读者已经知道的内容能明确说明代码是做什么的注释对我们是没有帮助的。//Ifthecolorisred,turnitgreenif(color.is_red()){color.turn_green();}要注释说明推理和历史如果代码中的业务逻辑以后可能需要更新或更... ...
目录
(为您整理了一些要点),点击可以直达。代码注释,可以说是比代码本身更重要。这里有一些方法可以确保你写在代码中的注释是友好的:
不要重复阅读者已经知道的内容
能明确说明代码是做什么的注释对我们是没有帮助的。
//Ifthecolorisred,turnitgreenif(color.is_red()){color.turn_green();}
要注释说明推理和历史
如果代码中的业务逻辑以后可能需要更新或更改,那就应该留下注释:)
/*TheAPIcurrentlyreturnsanarrayofitemseventhoughthatwillchangeinanupcomingticket.Therefore,besuretochangetheloopstyleheresothatweproperlyiterateoveranobject*/varapi_result={items:["one","two"]},items=api_result.items,num_items=items.length;for(varx=0;x<num_items;x++){...}
同一行的注释不要写得很长
没什么比拖动水平滚动条来阅读注释更令开发人员发指的了。事实上,大多数开发人员都会选择忽略这类注释,因为读起来真的很不方便。
functionPerson(name){this.name=name;this.first_name=name.split("")[0];//Thisisjustashotinthedarkhere.Ifwecanextractthefirstname,let'sdoit}
要把长注释放在逻辑上面,短注释放在后面
注释如果不超过120个字符那可以放在代码旁边。否则,就应该直接把注释放到语句上面。
if(person.age<21){person.can_drink=false;//21drinkingage/*Feesaregiventothoseunder25,butonlyinsomestates.*/person.has_car_rental_fee=function(state){if(state==="MI"){returntrue;}};}
不要为了注释而添加不必要的注释
画蛇添足的注释会造成混乱。也许在学校里老师教你要给所有语句添加注释,这会帮助开发人员更好地理解。但这是错的。谁要这么说,那你就立马上给他个两大耳刮子。代码应该保持干净简洁,这是毋庸置疑的。如果你的代码需要逐行解释说明,那么你最需要做的是重构。
if(person.age>=21){person.can_drink=true;//Apersoncandrinkat21person.can_smoke=true;//Apersoncansmokeat18person.can_wed=true;//Apersoncangetmarriedat18person.can_see_all_movies=true;//Apersoncanseeallmoviesat17//IhatebabiesandchildrenandallthingspurebecauseIcommenttoomuch}
注释要拼写正确
不要为代码注释中的拼写错误找借口。IDE可以为你检查拼写。如果没有这个功能,那就去下载插件,自己动手!
要多多练习
熟能生巧。试着写一些有用的注释,可以问问其他开发人员你的注释是否有用。随着时间的推移,你会慢慢懂得怎样才算是友好的注释。
要审查别人的注释
在代码审查时,我们往往会忽略查看注释。不要怕要求更多的注释,你应该提出质疑。如果每个人都养成写好注释的好习惯,那么世界将会更美好。
</div> <div class="zixun-tj-product adv-bottom"></div> </div> </div> <div class="prve-next-news">
java代码注释中的5要与3不要是什么的详细内容,希望对您有所帮助,信息来源于网络。