国产毛片a精品毛-国产毛片黄片-国产毛片久久国产-国产毛片久久精品-青娱乐极品在线-青娱乐精品

十大注釋技巧教你如何書寫容易閱讀的代碼

發布時間:2012-11-21 20:26    發布者:1770309616
關鍵詞: 編程 , 程序代碼
  很多程序員在寫代碼的時候往往都不注意代碼的可讀性,讓別人在閱讀代碼時花費更多的時間。其實,只要程序員在寫代碼的時候,注意為代碼加注釋,并以合理的格式為代碼加注釋,這樣就方便別人查看代碼,也方便自己以后查看了。下面分享十個加注釋的技巧:
  1. 逐層注釋
  為每個代碼塊添加注釋,并在每一層使用統一的注釋方法和風格。例如:
  針對每個類:包括摘要信息、作者信息、以及最近修改日期等;
  針對每個方法:包括用途、功能、參數和返回值等。
  在團隊工作中,采用標準化的注釋尤為重要。當然,使用注釋規范和工具(例如C#里的XML,Java里的Javadoc)可以更好的推動注釋工作完成得更好。
  2. 使用分段注釋
  如果有多個代碼塊,而每個代碼塊完成一個單一任務,則在每個代碼塊前添加一個注釋來向讀者說明這段代碼的功能。例子如下:
  // Check that all data records
  // are correct
  foreach (Record record in records)
  {
  if (rec.checkStatus()==Status.OK)
  {
  . . .
  }
  }
  // Now we begin to perform
  // transactions
  Context ctx = new ApplicationContext();
  ctx.BeginTransaction();
  3. 在代碼行后添加注釋
  如果多行代碼的每行都要添加注釋,則在每行代碼后添加該行的注釋,這將很容易理解。例如:
  const MAX_ITEMS = 10; // maximum number of packets
  const MASK = 0x1F; // mask bit TCP
  在分隔代碼和注釋時,有的開發者使用tab鍵,而另一些則使用空格鍵。然而由于tab鍵在各編輯器和IDE工具之間的表現不一致,因此最好的方法還是使用空格鍵。
  4. 不要侮辱讀者的智慧
  避免以下顯而易見的注釋:寫這些無用的注釋會浪費你的時間,并將轉移讀者對該代碼細節的理解。
  if (a == 5) // if a equals 5
  counter = 0; // set the counter to zero
  website = "http://www.xxx.net.cn"; // this is a website
  5. 禮貌點
  避免粗魯的注釋,如:“注意,愚蠢的使用者才會輸入一個負數”或“剛修復的這個問題出于最初的無能開發者之手”。這樣的注釋能夠反映到它的作者是多么的拙劣,你也永遠不知道誰將會閱讀這些注釋,可能是:你的老板,客戶,或者是你剛才侮辱過的無能開發者。
  6. 關注要點
  不要寫過多的需要轉意且不易理解的注釋。避免ASCII藝術,搞笑,詩情畫意,hyperverbosity的注釋。簡而言之,保持注釋簡單直接。
  7. 使用一致的注釋風格
  一些人堅信注釋應該寫到能被非編程者理解的程度。而其他的人則認為注釋只要能被開發人員理解就行了。無論如何,Successful Strategies for Commenting Code已經規定和闡述了注釋的一致性和針對的讀者。就個人而言,我懷疑大部分非編程人員將會去閱讀代碼,因此注釋應該是針對其他的開發者而言。
  8. 使用特有的標簽
  在一個團隊工作中工作時,為了便于與其它程序員溝通,應該采用一致的標簽集進行注釋。例如,在很多團隊中用TODO標簽表示該代碼段還需要額外的工作。
  int Estimate(int x, int y)
  {
  // TODO: implement the calculations
  return 0;
  }
  注釋標簽切忌不要用于解釋代碼,它只是引起注意或傳遞信息。如果你使用這個技巧,記得追蹤并確認這些信息所表示的是什么。
  9. 在代碼時添加注釋
  在寫代碼時就添加注釋,這時在你腦海里的是清晰完整的思路。如果在代碼最后再添加同樣注釋,它將多花費你一倍的時間。而“我沒有時間寫注釋”,“我很忙”和“項目已經延期了”這都是不愿寫注釋而找的借口。一些開發者覺得應該write comments before code,用于理清頭緒。例如:
  public void ProcessOrder()
  {
  // Make sure the products are available
  // Check that the customer is valid
  // Send the order to the store
  // Generate bill
  }
  10. 為自己注釋代碼
  當注釋代碼時,要考慮到不僅將來維護你代碼的開發人員要看,而且你自己也可能要看。用Phil Haack大師的話來說就是:“一旦一行代碼顯示屏幕上,你也就成了這段代碼的維護者”。因此,對于我們寫得好(差)的注釋而言,我們將是第一個受益者(受害者)。(tjwzjs)
本文地址:http://m.qingdxww.cn/thread-101845-1-1.html     【打印本頁】

本站部分文章為轉載或網友發布,目的在于傳遞和分享信息,并不代表本網贊同其觀點和對其真實性負責;文章版權歸原作者及原出處所有,如涉及作品內容、版權和其它問題,我們將根據著作權人的要求,第一時間更正或刪除。
hyfly 發表于 2012-11-22 19:35:28
學習了,謝謝!
jackxcj 發表于 2012-11-23 16:50:10
看過
您需要登錄后才可以發表評論 登錄 | 立即注冊

廠商推薦

  • Microchip視頻專區
  • Dev Tool Bits——使用MPLAB® Discover瀏覽資源
  • Dev Tool Bits——使用條件軟件斷點宏來節省時間和空間
  • Dev Tool Bits——使用DVRT協議查看項目中的數據
  • Dev Tool Bits——使用MPLAB® Data Visualizer進行功率監視
  • 貿澤電子(Mouser)專區

相關視頻

關于我們  -  服務條款  -  使用指南  -  站點地圖  -  友情鏈接  -  聯系我們
電子工程網 © 版權所有   京ICP備16069177號 | 京公網安備11010502021702
快速回復 返回頂部 返回列表
主站蜘蛛池模板: 韩国特黄毛片一级毛片免费 | 免费的黄色片视频 | 高清一区二区亚洲欧美日韩 | 国语对白自拍 | 高清欧美一区二区三区 | 日韩在线免费看 | 久久久久久综合对白国产 | 精品国产第一国产综合精品 | 成人三级在线视频 | 亚洲二区在线播放 | 91啦视频在线观看 | 99久久精品无码一区二区毛片 | 羞羞视频在线观免费观看 | 精品免费tv久久久久久久 | 九九热观看视频 | 日韩精品在线看 | 四虎影8818 | 我不卡影院在线观看 | 高清国产一级精品毛片基地 | 日韩毛片一级 | 五月婷婷之婷婷 | 欧美日韩视频在线成人 | 欧美日韩成人在线 | 日韩欧一级毛片在线播无遮挡 | 天天搞天天操 | 久久久精品国产四虎影视 | 亚洲第一区第二区 | 欧美日韩三区 | 久久这里只精品热免费99 | 羞羞视频导航 | 99精品视频在线观看免费 | 久久婷婷一区二区三区 | 男人插入视频 | 天堂网在线资源 | 99这里只有精品66视频 | 欧美人成一本免费观看视频 | 中文日产国产精品久久 | 四虎影免看黄 | 国产 欧美日韩 在线播放 | 天天色综合4 | 成人黄色免费观看 |