1. 對(duì)不同級(jí)別的代碼進(jìn)行注釋

對(duì)于不同級(jí)別的代碼塊，要使用統(tǒng)一的方法來進(jìn)行注釋。例如：

對(duì)于每一個(gè)類，需要包含一段簡(jiǎn)明扼要的描述，作者和上一次修改的時(shí)間

對(duì)于每一個(gè)方法，需要包含這個(gè)方法的用途，功能，參數(shù)以及返回結(jié)果

當(dāng)你在一個(gè)團(tuán)隊(duì)里面的時(shí)候，采用一套注釋的標(biāo)準(zhǔn)是非常重要的。當(dāng)然，使用一種大家都認(rèn)可的注釋約定和工具(例如C#的XML注釋和Java的Javadoc)在一定程度上能推動(dòng)這項(xiàng)任務(wù)。

2. 使用段落注釋

首先把代碼塊分解成多個(gè)“段落”，每一個(gè)段落都執(zhí)行單一的任務(wù);然后在每一個(gè)“段落”開始之前添加注釋，告訴閱讀代碼的人接下來的這段代碼是干什么用的

3. 對(duì)齊注釋行

對(duì)于那些在行末寫有注釋的代碼，應(yīng)該對(duì)齊注釋行來使得方便閱讀

有些開發(fā)人員使用tab來對(duì)齊注釋，而另外一些人會(huì)用空格來對(duì)齊。由于tab在不同的編輯器和集成開發(fā)環(huán)境中會(huì)有所不同，所以好的方法是使用空格來對(duì)齊注釋行。

4. 不要侮辱閱讀者的智慧

要避免沒用的注釋，例如

這不單把時(shí)間浪費(fèi)在寫沒用的注釋上面，同時(shí)也在分散讀者的注意力。

5. 要有禮貌

應(yīng)當(dāng)避免沒有禮貌的注釋，例如“要注意一些愚蠢的用戶會(huì)輸入一個(gè)負(fù)數(shù)”，或者“修正由菜鳥工程師寫的愚蠢得可憐的代碼而導(dǎo)致的副作用”。這樣的注釋對(duì)于代碼的寫注釋的人來說并沒有任何好處，同時(shí)你永遠(yuǎn)都不會(huì)知道將來這些注釋會(huì)被誰來閱讀，你的老板，一個(gè)客戶或者是剛才被你數(shù)落的愚蠢得可憐的工程師。

6. 直截了當(dāng)

不要在注釋里面寫過多的廢話。避免在注釋里面賣弄ASCII藝術(shù)，寫笑話，作詩和過于冗長(zhǎng)。簡(jiǎn)而言之就是保持注釋的簡(jiǎn)單和直接。

7. 使用統(tǒng)一的風(fēng)格

有些人覺得注釋應(yīng)該讓非程序員也能看懂。另外一些人覺得注釋需要面對(duì)的讀者只是程序員。無論如何，正如Successful Strategies for Commenting Code中所說的，最重要的是注釋的風(fēng)格需要統(tǒng)一，并且總是面向相同的讀者。就自己而論，我懷疑非程序員是否會(huì)去讀代碼，所以我覺得注釋應(yīng)該面向程序員來寫。

網(wǎng)站題目：成都養(yǎng)成好習(xí)慣關(guān)于代碼注釋的7個(gè)技巧
分享路徑：http://vcdvsql.cn/news/240542.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站內(nèi)鏈、動(dòng)態(tài)網(wǎng)站、定制網(wǎng)站、App開發(fā)、網(wǎng)站導(dǎo)航、定制開發(fā)

廣告

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