本篇文章給大家分享的是有關web開發(fā)中要避免的程序注釋方式有哪些，小編覺得挺實用的，因此分享給大家學習，希望大家閱讀完這篇文章后可以有所收獲，話不多說，跟著小編一起來看看吧。

創(chuàng)新互聯(lián)建站專業(yè)為企業(yè)提供閩侯網(wǎng)站建設、閩侯做網(wǎng)站、閩侯網(wǎng)站設計、閩侯網(wǎng)站制作等企業(yè)網(wǎng)站建設、網(wǎng)頁設計與制作、閩侯企業(yè)網(wǎng)站模板建站服務，10多年閩侯做網(wǎng)站經(jīng)驗，不只是建網(wǎng)站，更提供有價值的思路和整體網(wǎng)絡服務。

你是否曾在檢查代碼時碰到一條在你看來多余的注釋？在代碼中使用注釋的目的是提升代碼的可讀性，以讓那些非原始代碼開發(fā)者能更好地理解它們。

我甄別出5類讓我不勝其擾的注釋及5類生成它們的程序員。我希望讀過本篇之后，你不會與他們一樣墜入同一條河流。作為一項挑戰(zhàn)，你不妨把寫這5類注釋的程序員與5類程序員[英文]作一下匹配。

1. 驕傲型程序員

public class Program  {      static void Main(string[] args)      {          string message = "Hello World!";  // 07/24/2010 Bob          Console.WriteLine(message); // 07/24/2010 Bob          message = "I am so proud of this code!"; // 07/24/2010 Bob          Console.WriteLine(message); // 07/24/2010 Bob      }  }

這類程序員對其代碼自視甚高，以至于他覺得有必要在每行代碼后都要簽上自己的大名。應用版本控制系統(tǒng)（VCS）是能知道誰修改了代碼，但是乍看之下責任人也不會如此打眼。

2. 過時型程序員

public class Program  {      static void Main(string[] args)      {          /* This block of code is no longer needed           * because we found out that Y2K was a hoax           * and our systems did not roll over to 1/1/1900 */         //DateTime today = DateTime.Today;          //if (today == new DateTime(1900 1 1))          //{          //    today = today.AddYears(100);          //    string message = "The date has been fixed for Y2K.";          //    Console.WriteLine(message);          //}      }  }

如果一段代碼不再使用了（也就是過時了），請刪除它——勿要讓你的工作代碼被數(shù)行冗余的注釋弄得七零八亂。而且，你任何時候需要復制這段刪除的代碼，都可以使用版本控制系統(tǒng)，這樣你便能從以前版本中恢復出它來。

3. 顯然型程序員

public class Program  {      static void Main(string[] args)      {          /* This is a for loop that prints the            * words "I Rule!" to the console screen            * 1 million times each on its own line. It           * accomplishes this by starting at 0 and            * incrementing by 1. If the value of the            * counter equals 1 million the for loop           * stops executing.*/         for (int i = 0; i < 1000000; i++)          {              Console.WriteLine("I Rule!");          }      }  }

我們都知道編程的基本工作邏輯——這可不是什么“編程入門”！你無需浪費時間解釋顯而易見的程序工作原理，雖然我們很高興看到你愿意解釋代碼的功能——但這不過是畫蛇添足。

4. 傳記型程序員

public class Program  {      static void Main(string[] args)      {         /* I discussed with Jim from Sales over coffee           * at the Starbucks on main street one day and he          * told me that Sales Reps receive commission           * based upon the following structure.           * Friday: 25%          * Wednesday: 15%          * All Other Days: 5%          * Did I mention that I ordered the Caramel Latte with          * a double shot of Espresso?          */         double price = 5.00;          double commissionRate;          double commission;          if (DateTime.Today.DayOfWeek == DayOfWeek.Friday)          {              commissionRate = .25;          }          else if (DateTime.Today.DayOfWeek == DayOfWeek.Wednesday)          {              commissionRate = .15;          }          else         {              commissionRate = .05;          }          commission = price * commissionRate;      }  }

如果你非得在代碼中提到某些必需的東西，也別提到人名。Jim from Sales（譯注：銷售人員Jim）也許離開這家公司了，那些閱讀代碼的程序員極可能根本就不知道他是誰，更甭提注釋里那些毫無干系的事情。

5. “總有一天”型程序員

public class Program  {      static void Main(string[] args)      {         //TODO: I need to fix this someday – 07/24/1995 Bob         /* I know this error message is hard coded and          * I am relying on a Contains function but           * someday I will make this code print a           * meaningful error message and exit gracefully.          * I just don’t have the time right now.         */        string message = "An error has occurred";         if(message.Contains("error"))         {             throw new Exception(message);         }      }  }

這類注釋在某種程度上說是前面幾種類型的大雜燴。TODO注釋在項目初始開發(fā)階段用處不小，但是如果幾年后出現(xiàn)在產(chǎn)品代碼中——那就會帶來麻煩。如果有什么需要修補的，趁現(xiàn)在動手，而不要推遲到以后去做。

以上就是web開發(fā)中要避免的程序注釋方式有哪些，小編相信有部分知識點可能是我們?nèi)粘９ぷ鲿姷交蛴玫降摹ＯＭ隳芡ㄟ^這篇文章學到更多知識。更多詳情敬請關注創(chuàng)新互聯(lián)行業(yè)資訊頻道。

網(wǎng)頁標題：web開發(fā)中要避免的程序注釋方式有哪些
網(wǎng)站網(wǎng)址：http://aaarwkj.com/article48/pjsoep.html

成都網(wǎng)站建設公司_創(chuàng)新互聯(lián)，為您提供品牌網(wǎng)站建設、動態(tài)網(wǎng)站、網(wǎng)站內(nèi)鏈、服務器托管、自適應網(wǎng)站、企業(yè)建站

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉載內(nèi)容為主，如果涉及侵權請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉載，或轉載時需注明來源： 創(chuàng)新互聯(lián)