评释简略代码会做对对首要评释的领会。程序开垦者最佳能用最精要的评释来诠释中心代码。
举个例子，你翻开一个电箱，内里有几百根电线，蒙了吧。再一看，每根电线上头都有一个整齐的小标签。真是谢天谢地啊！然则，当你一个个去翻看标签的时刻，见鬼的，险些通盘的标签都是空白的！
尔后，在你花了整整一个小时去涉猎每一个小标签往后，终归给你找到12条有效的消息，忠心喜大普奔！自然，期盼在你思维一片混乱的时刻得出的结束依然是准确的，没有脱漏，呵呵呵。
当我须要研讨代码的时刻看到随处都是废物评释，唉，我的感慨就和上头在那末多标签内里找有效的相同。见鬼的，想从一大堆废物评释里确定哪个有效几乎就像铁树开花！
说一个罕用的开源项目，内里都是这些废物评释：
/**
*__constructfunction.
*
*
accesspublic*
returnvoid*/
publicfunction__construct(){
…
}
再来一个：
/**
*Constructor
*/
publicfunction__construct(){
…
}
再有一个：
//Convertfloattostring
$value=float_to_string($value);
这些评释就跟电箱里的空白标签相同，亮堂堂的摆在哪里，增长做对还升高评释的可用性。看到云云的评释，怪不得那些不幸的开垦人员要孜孜不倦了。
我敢确定，阿谁把空白标签贴在每根电线上的电工自以为这是一个特棒的想法，他协助了那些在他反面来的人：他们有甚么想写的，只需在这些曾经贴好的标签上头写就也许了。自然也有或者他向来企图本身填好通盘标签。撇开他的善意不说，云云做的结真的心是糟透了，还不如只贴那有效的12张呢！
在编程的时刻，开垦人员屡屡被示知要评释，然则他们中很少见人晓得怎么评释才好。以是开垦人员评释代码的时刻，并不是由于有须要，而是由于他们感慨这是责任。开垦人员以为倘使在代码中多多评释，能展现他们做事本事。
见鬼的，这也不晓得是哪门子的理论。我最讨厌每隔几行代码就有评释，而现实上却屁用没有。评释的效用绝对不是为了地道卖弄咱们是“不明觉厉”的程序员，而是为了中心纪录咱们搞这些代码的缘故。云云一来，那些废物评释就可以滚开了。看上面的例子:
//Weneedtoaccountforproductpricechanges,
//sowegetthepriceoftheproductwheneachorderoccurred
$order_prices=$this-get_order_prices();
说说我的做法吧，当我思索是不是要写评释的时刻，我就问本身：倘使往后回过甚来看这些代码，我能不能一下子领会起初为甚么要云云写？倘使往后我会特别谢谢这些评释，那末想也不必想，坚决写上评释。不然，就让那些废物评释见鬼去吧。
原文：