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

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

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

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

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

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

　　2. 注釋不維護(hù)

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

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

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

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

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

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

　　3. 代碼只注釋，不刪除

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