1、版權(quán)和版本

　　———————

　　好的程序員會(huì)給自己的每個(gè)函數(shù)，每個(gè)文件，都注上版權(quán)和版本。

　　對(duì)于C/C++的文件，文件頭應(yīng)該有類似這樣的注釋：

　　/************************************************************************

　　* 文件名：network.c

　　* 文件描述：網(wǎng)絡(luò)通訊函數(shù)集

　　* 創(chuàng)建人： Hao Chen, 2003年2月3日

　　* 版本號(hào)：1.0

　　* 修改記錄：

　　************************************************************************/

　　而對(duì)于函數(shù)來(lái)說(shuō)，應(yīng)該也有類似于這樣的注釋：

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

　　* 函 數(shù) 名：XXX

　　* 參 數(shù)：

　　* type name [IN] : descripts

　　* 功能描述:

　　* ..............

　　* 返 回 值：成功TRUE，失敗FALSE

　　* 拋出異常：

　　* 作 者：ChenHao 2003/4/2

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

　　這樣的描述可以讓人對(duì)一個(gè)函數(shù)，一個(gè)文件有一個(gè)總體的認(rèn)識(shí)，對(duì)代碼的易讀性和易維護(hù)

　　性有很大的好處。這是好的作品產(chǎn)生的開始。

　　2、縮進(jìn)、空格、換行、空行、對(duì)齊

　　————————————————

　　i) 縮進(jìn)應(yīng)該是每個(gè)程序都會(huì)做的，只要學(xué)程序過(guò)程序就應(yīng)該知道這個(gè)，但是我仍然看過(guò)不 縮進(jìn)的程序，或是亂縮進(jìn)的程序，如果你的公司還有寫程序不縮進(jìn)的程序員，請(qǐng)毫不猶豫 的開除他吧，并以破壞源碼罪起訴他，還要他賠償讀過(guò)他程序的人的精神損失費(fèi)�？s進(jìn)， 這是不成文規(guī)矩，我再重提一下吧，一個(gè)縮進(jìn)一般是一個(gè)TAB鍵或是4個(gè)空格。(最好用TAB 鍵)

　　ii) 空格�？崭衲芙o程序代來(lái)什么損失嗎?沒(méi)有，有效的利用空格可以讓你的程序讀進(jìn)來(lái)更加賞心悅目。而不一堆表達(dá)式擠在一起�？纯聪旅娴拇�碼：

　　ha=(ha*128+*key++)%tabPtr->size;

　　ha = ( ha * 128 + *key++ ) % tabPtr->size;

　　有空格和沒(méi)有空格的感覺不一樣吧。一般來(lái)說(shuō)，語(yǔ)句中要在各個(gè)操作符間加空格，函數(shù)調(diào)用時(shí)，要以各個(gè)參數(shù)間加空格。如下面這種加空格的和不加的：

　　if ((hProc=OpenProcess(PROCESS_ALL_ACCESS,FALSE,pid))==NULL){

　　}

　　if ( ( hProc = OpenProcess(PROCESS_ALL_ACCESS, FALSE, pid) ) == NULL ){

　　}

　　iii) 換行。不要把語(yǔ)句都寫在一行上，這樣很不好。如：

　　for(i=0;i’9’)&&(a[i]<’a’||a[i]>’z’)) break;

　　我拷，這種即無(wú)空格，又無(wú)換行的程序在寫什么啊?加上空格和換行吧。

　　for ( i=0; i if ( ( a[i] < ’0’ || a[i] > ’9’ ) &&

　　( a[i] < ’a’ || a[i] > ’z’ ) ) {

　　break;

　　}

　　}

　　好多了吧?有時(shí)候，函數(shù)參數(shù)多的時(shí)候，最好也換行，如：

　　CreateProcess(

　　NULL,

　　cmdbuf,

　　NULL,

　　NULL,

　　bInhH,

　　dwCrtFlags,

　　envbuf,

　　NULL,

　　&siStartInfo,

　　&prInfo

　　);

　　條件語(yǔ)句也應(yīng)該在必要時(shí)換行：

　　if ( ch >= ’0’ || ch <= ’9’ ||

　　ch >= ’a’ || ch <= ’z’ ||

　　ch >= ’A’ || ch <= ’Z’ )

　　iv) 空行。不要不加空行，空行可以區(qū)分不同的程序塊，程序塊間，最好加上空行。如：

　　HANDLE hProcess;

　　PROCESS_T procInfo;

　　/* open the process handle */

　　if((hProcess = OpenProcess(PROCESS_ALL_ACCESS, FALSE, pid)) == NULL)

　　{

　　return LSE_MISC_SYS;

　　}

　　memset(&procInfo, 0, sizeof(procInfo));

　　procInfo.idProc = pid;

　　procInfo.hdProc = hProcess;

　　procInfo.misc |= MSC***A_PROC;

　　return(0);

　　v) 對(duì)齊。用TAB鍵對(duì)齊你的一些變量的聲明或注釋，一樣會(huì)讓你的程序好看一些。如：

　　typedef struct _pt_man_t_ {

　　int numProc; /* Number of processes */

　　int maxProc; /* Max Number of processes */

　　int maxProc; /* Max Number of processes */

　　int numEvnt; /* Number of events */

　　int maxEvnt; /* Max Number of events */

　　HANDLE* pHndEvnt; /* Array of events */

　　DWORD timeout; /* Time out interval */

　　HANDLE hPipe; /* Namedpipe */

　　TCHAR usr[MAXUSR];/* User name of the process */

　　int numMsg; /* Number of Message */

　　int Msg[MAXMSG];/* Space for intro process communicate */

　　} PT_MAN_T;

　　怎么樣?感覺不錯(cuò)吧。

　　這里主要講述了如果寫出讓人賞心悅目的代碼，好看的代碼會(huì)讓人的心情愉快，讀起代碼也就不累，工整、整潔的程序代碼，通常更讓人歡迎，也更讓人稱道�，F(xiàn)在的硬盤空間這么大，不要讓你的代碼擠在一起，這樣它們會(huì)抱怨你虐待它們的。好了，用“縮進(jìn)、空格、換行、空行、對(duì)齊”裝飾你的代碼吧，讓他們從沒(méi)有秩序的土匪中變成一排排整齊有秩序的正規(guī)部隊(duì)吧。