編程做好這六點(diǎn)，你就是大師了

　　三、 添加盡可能詳盡的注釋

　　不要總覺(jué)得自己當時(shí)記憶深刻，甚至刻骨銘心、終生難忘，時(shí)間總是會(huì )無(wú)情地證明你是錯的，為你的程序添加詳盡的注釋?zhuān)热?a class="contentlabel" href="http://dyxdggzs.com/news/listbylabel/label/變量">變量的用途、函數的調用關(guān)系、參數說(shuō)明、函數功能等等都要盡可能詳細地寫(xiě)明，有時(shí)候即使是寫(xiě)下來(lái)，過(guò)一段時(shí)間再回頭看時(shí)還要在琢磨一陣，若是不寫(xiě)，后果可想而知，別人就更沒(méi)法讀你的程序了。

　　這是我為一個(gè)函數寫(xiě)的注釋?zhuān)斎幻總€(gè)人都有自己的寫(xiě)法，我一般這樣來(lái)寫(xiě)的，僅供參考哈。

　　/*=============================================================================

　　*
　　* 函 數 名： CMD_Send()
　　*
　　* 參 數：??????? length_low 數據長(cháng)度
　　*???????????????????? ?CMD_byte 命令字節
　　*???????????????????? ?CMD_parameter 命令參數
　　*???????????????????? ?*data 語(yǔ)音數據
　　* 功能描述:
　　*??????????????????? ? 發(fā)送一幀語(yǔ)音數據
　　*
　　* 返 回 值： 無(wú)
　　=============================================================================*/

　　四、 做好底層的定義

　　這里的意思是與硬件相關(guān)的程序，為了后期更好地編程，先做一些必要的定義，比如
?????????#define cWL_PIN_SDIO 0x04
　　#define SDIO_is_Out P1DIR |= cWL_PIN_SDIO

　　這樣以后用起來(lái)就十分的方便，就像說(shuō)話(huà)一樣，使得程序十分易讀，當然凡事過(guò)猶不及，也沒(méi)必要過(guò)多地定義，只對一些經(jīng)常使用的定義就好，也有的編程環(huán)境中，本身就已經(jīng)做了非常詳盡的定義，那么就省了你的事了，但這也未必是好事，因為你要花很多時(shí)間去看，去熟悉。

　　五、 合理劃分單元和函數

　　尤其在程序量比較大的時(shí)候，這一點(diǎn)就顯得尤為重要，劃分得好不好，對于后期編程影響極大。合理劃分單元說(shuō)得通俗點(diǎn)就是把每一個(gè)功能單元放在一個(gè)單獨的文件中，這樣每一個(gè)文件中的程序量就不至于太長(cháng)，需要被外部調用的函數全部在頭文件中引出，劃分函數也很重要，函數劃分得好，可以節省很多程序空間，增強代碼執行效率。這樣做的好處是極大地增強了程序的可移植性，下次再用到這個(gè)功能時(shí)，只需要修改底層的IO口就可以了，這樣久而久之，當你寫(xiě)的單元足夠多的時(shí)候，寫(xiě)程序就變得越來(lái)越輕松了。還有在文件的起始處最好也加一些功能說(shuō)明，也就是注釋?zhuān)纾?/p>

　　/*=============================================================================

　　* 說(shuō) 明：
　　*??????????????? 本單元實(shí)現了語(yǔ)音輸出‘宇音天下’的功能。
　　* 作 者： XXX 2011/3/3
　　*　　=============================================================================*/

　　六、 反復修改，精益求精

　　無(wú)論我們如何用心的去編寫(xiě)程序，程序似乎總是有改進(jìn)的余地，當你發(fā)現一個(gè)可以改進(jìn)的地方，可能是一個(gè)好的算法，也可能僅僅是一個(gè)冗余的變量，也要不厭其煩地去重新改過(guò)，這樣日積月累，就可以不斷完善你自己的程序庫，因為當程序庫足夠充足、足夠完善的時(shí)候，寫(xiě)程序就幾乎是信手拈來(lái)了。

　　七、 總結

　　其實(shí)以上說(shuō)的程序設計幾點(diǎn)經(jīng)驗，每一點(diǎn)都是在一個(gè)最根本的原則的指引之下，那就是增強程序的可讀性和可移植性。最后送大家一句話(huà)，與大家共勉“If you will，you can!!!”。