建站
咨詢
售后
建站咨詢
新聞中心
寫注釋如果方法不對(duì)，是比沒寫還惡劣的行為!
成都創(chuàng)新互聯(lián)公司專注于涼山州企業(yè)網(wǎng)站建設(shè),響應(yīng)式網(wǎng)站,商城建設(shè)。涼山州網(wǎng)站建設(shè)公司,為涼山州等地區(qū)提供建站服務(wù)。全流程按需制作，專業(yè)設(shè)計(jì)，全程項(xiàng)目跟蹤，成都創(chuàng)新互聯(lián)公司專業(yè)和態(tài)度為您提供的服務(wù)
我想到的，常見的情況有：
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ù)簡直就是噩夢(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é)果代碼里到處都是“注釋”，沒有一句是有用的。讀代碼的人也不敢刪，一直留著留著。
文章題目：寫代碼時(shí)注意規(guī)范
文章URL：http://ef60e0e.cn/article/eihcjh.html
