寫注釋如果方法不對(duì)，是比沒寫還惡劣的行為!

　　我想到的，常見的情況有：

　　1. 注釋不規(guī)范或過度注釋

　　隨意的，到處都是注釋，有用沒用的都寫，比如：

　　a = 1; // 給 a 賦值為1

　　誰還看不懂 a=1 是做啥么...

　　2. 注釋不維護(hù)

　　業(yè)務(wù)變化比較快的系統(tǒng)，需要連續(xù)不斷的開發(fā)，你要一直對(duì)它做維護(hù)性質(zhì)的開發(fā)，有時(shí)候要不斷的修改代碼以適應(yīng)業(yè)務(wù)的變化。這時(shí)候問題就來了。。

　　比如某個(gè)函數(shù)一開始是做A這件事，第一個(gè)人為這個(gè)函數(shù)寫了注釋是A，后來業(yè)務(wù)變化，第二個(gè)人把這個(gè)函數(shù)改成做B這件事了，然后測(cè)試通過，沒問題了。此時(shí)注釋還是A. 后來第三個(gè)人改成了做C，注釋仍然是A。

　　函數(shù)的功能可測(cè)，但是注釋不可測(cè)，注釋需要人的維護(hù)，如果不維護(hù)簡(jiǎn)直就是噩夢(mèng)。

　　假設(shè)有第四個(gè)人過來讀代碼，看到注釋都是A的內(nèi)容，他是不是會(huì)一頭霧水呢?

　　有些注釋，有人認(rèn)為很有用，但我覺得在這種場(chǎng)景下不一定。

　　比如有人喜歡 @ xxx 在函數(shù)或者類的前邊標(biāo)記自己的大名，我就覺得這個(gè)做法在多人、業(yè)務(wù)變化的開發(fā)場(chǎng)景下，很雞肋。通常人家把你的代碼改得面目全非了，看作者還是你，今后出了問題，后來人詛咒的是你這個(gè) xxx 啊....

　　3. 代碼只注釋，不刪除

　　很多人寫代碼總有這種習(xí)慣，一段代碼不用了，注釋掉，心里總想著這段代碼以后可能還會(huì)用。但大多數(shù)情況下，過幾天就忘了，結(jié)果代碼里到處都是“注釋”，沒有一句是有用的。讀代碼的人也不敢刪，一直留著留著。