一直以來(lái)我沒(méi)有見(jiàn)過(guò)任何科學(xué)研究證明了這一點(diǎn)，但在軟件領(lǐng)域，它就像一個(gè)教條或一個(gè)共同的信念。由于它的存在，將軟件寫(xiě)得易于閱讀、關(guān)注代碼的可讀型都是很重要的。通過(guò)一些技術(shù)的輔助程序員可以實(shí)現(xiàn)這些要求，這些技術(shù)其中之一就是寫(xiě)代碼注釋。

免責(zé)聲明：我所說(shuō)的“避免代碼注釋”并不意味著我不寫(xiě)注釋?zhuān)@意味著，我盡可能避免寫(xiě)代碼注釋?zhuān)?dāng)我覺(jué)得值得寫(xiě)時(shí)我還是寫(xiě)的。

“相比寫(xiě)軟件我們花了更多的時(shí)間在閱讀軟件上”，一直以來(lái)我沒(méi)有見(jiàn)過(guò)任何科學(xué)研究證明了這一點(diǎn)，但在軟件領(lǐng)域，它就像一個(gè)教條或一個(gè)共同的信念。由于它的存在，將軟件寫(xiě)得易于閱讀、關(guān)注代碼的可讀型都是很重要的。通過(guò)一些技術(shù)的輔助程序員可以實(shí)現(xiàn)這些要求，這些技術(shù)其中之一就是寫(xiě)代碼注釋。

當(dāng)談?wù)撈鸫a注釋的時(shí)候，有關(guān)的辯論總無(wú)休止。我們應(yīng)該用注釋來(lái)說(shuō)明我們代碼的作用嗎，我們應(yīng)該將重點(diǎn)放在代碼的表達(dá)性而不需要注釋來(lái)輔助閱讀嗎？Joe Kunk為這爭(zhēng)論寫(xiě)了一篇博客 - 應(yīng)不應(yīng)該寫(xiě)注釋。有那些人說(shuō)文檔完備的代碼被認(rèn)為是好代碼，還有些人說(shuō)應(yīng)該避免注釋?zhuān)驗(yàn)樽⑨屚ǔ１挥脕?lái)解釋/隱藏不好的代碼。

在我看來(lái)，在書(shū)籍的影響下，為確保代碼整潔便于重構(gòu)，我們應(yīng)該避免寫(xiě)注釋?zhuān)俏覀冇幸粋€(gè)好的寫(xiě)注釋的理由（例如數(shù)學(xué)算法）或因?yàn)楣疽蠡蛄鞒涛覀冇辛x務(wù)這樣做。下面是我關(guān)于注釋的五點(diǎn)憂慮。

我認(rèn)為代碼注釋起到反作用的地方

1.注釋往往鼓勵(lì)壞的代碼

“注釋的代碼是好代碼”有這樣一個(gè)說(shuō)法，所以人們常常在代碼中添加注釋以代碼漂亮。如果我們?yōu)榱私忉尨a而添加注釋這就像是一個(gè)信號(hào)：也許我們正在編寫(xiě)糟糕的代碼。當(dāng)我們要寫(xiě)一條注釋是，我們應(yīng)該想是否能夠通過(guò)清理代碼使它更有可讀性呢。

2. 我們將花費(fèi)更多的時(shí)間來(lái)編寫(xiě)和維護(hù)

注釋通常是代碼的第二個(gè)版本。當(dāng)我們?yōu)橐粋€(gè)函數(shù)寫(xiě)注釋時(shí)我們實(shí)際在重復(fù)自己。我們違背了DRY（不要重復(fù)自己）原則。我們正在花費(fèi)更多的時(shí)間且增加了復(fù)雜性。需求如果變了代碼也要跟著變，如果我們寫(xiě)了注釋也要隨之更改。所以為多花費(fèi)的一倍時(shí)間做出改變吧。我們可以利用這段時(shí)間來(lái)提高我們的代碼或開(kāi)發(fā)新的功能。

3. 注釋是不可測(cè)試和驗(yàn)證的

當(dāng)我們修改代碼的時(shí)候我們借助諸如編譯器、IDE及單元測(cè)試工具來(lái)輔助，注釋沒(méi)有，沒(méi)有類(lèi)似工具。你無(wú)法依靠工具或單元測(cè)試來(lái)確保它們的使用位置、日期標(biāo)注等是正確的。一旦你寫(xiě)了一條注釋?zhuān)驗(yàn)樗遣豢蓽y(cè)試的無(wú)法關(guān)注它的準(zhǔn)確性，一旦出錯(cuò)便會(huì)無(wú)法察覺(jué)的保留下來(lái)。

4. 與代碼相比注釋是不可靠的

通常當(dāng)注釋和代碼脫離它就變得與沒(méi)有多大意義了。如果程序員讀到它就可能被誤導(dǎo)。即使沒(méi)有誤導(dǎo)也需要通過(guò)閱讀源碼來(lái)搞清到底做了什么。一個(gè)實(shí)際的例子，如果我們的老板需要我們做一個(gè)修改，我們應(yīng)該看注釋還是代碼呢？當(dāng)然我們會(huì)看代碼。

5. 注釋占用了不少屏幕空間

一些注釋方法（像下面的）占了很多行，當(dāng)你想查看更多代碼時(shí)這便成了一個(gè)問(wèn)題。

/**

*

* @param title The title of the CD

* @param author The author of the CD

* @param tracks The number of tracks on the CD

* @param durationInMinutes The duration of the CD in minutes

*/

public void addCD(String title, String author,

int tracks, int durationInMinutes) {

CD cd = new CD();

cd.title = title;

cd.author = author;

cd.tracks = tracks;

cd.duration = duration;

cdList.add(cd);

}