日韩无码专区无码一级三级片|91人人爱网站中日韩无码电影|厨房大战丰满熟妇|AV高清无码在线免费观看|另类AV日韩少妇熟女|中文日本大黄一级黄色片|色情在线视频免费|亚洲成人特黄a片|黄片wwwav色图欧美|欧亚乱色一区二区三区

看到標題，我知道你可能會想：“我為什么要避免代碼注釋，這難道不是一件好事嗎？”。是的，寫注釋在大多數(shù)情況下是有用的。但是，請注意，我說的是“在大多數(shù)情況下”，因為有一些情況下，你不應(yīng)該寫注釋。

創(chuàng)新互聯(lián)公司是一家專注于成都網(wǎng)站制作、成都做網(wǎng)站與策劃設(shè)計,石泉網(wǎng)站建設(shè)哪家好?創(chuàng)新互聯(lián)公司做網(wǎng)站,專注于網(wǎng)站建設(shè)10余年,網(wǎng)設(shè)計領(lǐng)域的專業(yè)建站公司;建站業(yè)務(wù)涵蓋:石泉等地區(qū)。石泉做網(wǎng)站價格咨詢:13518219792

還不相信？那讓我告訴你：寫注釋有時會壞事！會導(dǎo)致壞代碼！

請允許我用一句名言來開始我的論證：

不要注釋壞代碼——重寫吧?！狟rian W. Kernighan and P. J. Plaugher

這句話給我流下了非常深刻的印象。仔細想一想，有多少次你注釋你的代碼，只是因為擔(dān)心自己將來再回過頭來閱讀的時候可能會不理解它的意思？至少都做過一次吧。坦率地說，我有很多次是因為這個原因才注釋的，尤其是在那些我還是重構(gòu)和編寫干凈代碼的新手的日子里。

那么，為什么這樣的注釋反而不好呢？簡而言之是因為，我們會因為有注釋而放任編寫壞的代碼！正如你所看到的，注釋有時候反而激勵了我們?nèi)懸恍┎徽麧嵉拇a。

另一個原因是因為注釋會誤導(dǎo)我們。有多少次你已經(jīng)改變了代碼，卻忘了改旁邊的注釋？別否認，這種事時常發(fā)生。這就是為什么你經(jīng)常聽到這樣一句話，“真理只存在于代碼中”。

那么，什么時候你不應(yīng)該寫注釋呢？

有一個經(jīng)驗法則就是，無論何時你發(fā)現(xiàn)自己要使用注釋來解釋這段代碼是用來干什么的時候，那么基本上就是你的代碼需要重構(gòu)以變得更整潔的時候。

典型的解決方案

現(xiàn)在你知道為什么有時候反而要避免寫注釋了，那么有什么解決辦法嗎。事實上，目前還沒有一個有效的解決方案，但是你可以清潔你的代碼，這樣你（以及其他人）就可以在沒有注釋的情況下也能理解它了。

為了用可讀的代碼替換掉注釋，通常我們的典型解決方法是使用提取方法重構(gòu)（Extract Method refactoring）。這種重構(gòu)方式是我最喜歡的。對此我也寫過一篇博客，里面有完整的例子：《Break Your Method Into Smaller Ones》。

下面讓我們看一個簡單說明如何提高你的代碼，從而解放注釋的例子。

 
 
  
  
  
  
 
  
  
// Check to see if the customer can get free product 
  
  
if ($customer->isPremium() and $customer->numberOfPurchases > 8) { 
  
  
 
  
  
} 
  
  
 
  
  
// OR 
  
  
 
  
  
if ($customer->canGetFreeProduct()) { 
  
  
 
  
  
} 
 

我希望你能注意到這兩個條件語句之間的差異。哪一個更整潔？很明顯第二個更整潔，更好。這是因為，首先，可以刪除注釋，因為我們看代碼就明白了意 思。其次，也是最重要的一點是，我們提取了檢查客戶是否值得獲得免費產(chǎn)品的邏輯到它的方法中，這是一件好事，特別是當(dāng)你想要在應(yīng)用程序中再次使用它的話。

對于更詳細的例子，我推薦你閱讀我以前發(fā)表過的文章。

結(jié)論

請允許我用一個免責(zé)說明來結(jié)束這篇文章。我不反對注釋。注釋在大多數(shù)情況下是非常有用的，尤其是在開源項目中。

我想說的是，你不應(yīng)該為你的壞代碼注釋。請記住，“真理只存在于代碼中”。

譯文鏈接：http://www.codeceo.com/article/when-avoid-comment-code.html
英文原文：When Should You Avoid Commenting Your Code?

標題名稱：什么時候應(yīng)該避免注釋代碼？
標題鏈接：http://www.5511xx.com/article/dhoseep.html