1.?基本要求
1.1?程序結(jié)構(gòu)清析，簡單易懂，單個函數(shù)的程序行數(shù)不得超過100行。
1.2?打算干什么，要簡單，直接了當，代碼精簡，避免垃圾程序。
1.3?盡量使用標準庫函數(shù)和公共函數(shù)。
1.4?不要隨意定義全局變量，盡量使用局部變量。
1.5?使用括號以避免二義性。

2.可讀性要求
2.1?可讀性第一，效率第二。
2.2?保持注釋與代碼完全一致。
2.3?每個源程序文件，都有文件頭說明，說明規(guī)格見規(guī)范。
2.4?每個函數(shù)，都有函數(shù)頭說明，說明規(guī)格見規(guī)范。
2.5?主要變量（結(jié)構(gòu)、聯(lián)合、類或?qū)ο螅┒x或引用時，注釋能反映其含義。
2.7?常量定義（DEFINE）有相應說明。
2.8?處理過程的每個階段都有相關(guān)注釋說明。
2.9?在典型算法前都有注釋。
2.10?利用縮進來顯示程序的邏輯結(jié)構(gòu)，縮進量一致并以Tab鍵為單位，定義Tab為?6個
字節(jié)。
2.11?循環(huán)、分支層次不要超過五層。
2.12?注釋可以與語句在同一行，也可以在上行。
2.13?空行和空白字符也是一種特殊注釋。
2.14?一目了然的語句不加注釋。
2.15?注釋的作用范圍可以為：定義、引用、條件分支以及一段代碼。
2.16?注釋行數(shù)（不包括程序頭和函數(shù)頭說明部份）應占總行數(shù)的?1/5?到?1/3?。

3.?結(jié)構(gòu)化要求
3.1?禁止出現(xiàn)兩條等價的支路。
3.2?禁止GOTO語句。
3.3?用?IF?語句來強調(diào)只執(zhí)行兩組語句中的一組。禁止?ELSE?GOTO?和?ELSE?RETURN。
3.4?用?CASE?實現(xiàn)多路分支。
3.5?避免從循環(huán)引出多個出口。
3.6?函數(shù)只有一個出口。
3.7?不使用條件賦值語句。
3.8?避免不必要的分支。
3.9?不要輕易用條件分支去替換邏輯表達式。

4.?正確性與容錯性要求
4.1?程序首先是正確，其次是優(yōu)美
4.2?無法證明你的程序沒有錯誤，因此在編寫完一段程序后，應先回頭檢查。
4.3?改一個錯誤時可能產(chǎn)生新的錯誤，因此在修改前首先考慮對其它程序的影響。
4.4?所有變量在調(diào)用前必須被初始化。
4.5?對所有的用戶輸入，必須進行合法性檢查。
4.6?不要比較浮點數(shù)的相等，
如：?10.0?*?0.1?==?1.0?，?不可靠
4.7?程序與環(huán)境或狀態(tài)發(fā)生關(guān)系時，必須主動去處理發(fā)生的意外事件，如文件能否
邏輯鎖定、打印機是否聯(lián)機等。
4.8?單元測試也是編程的一部份，提交聯(lián)調(diào)測試的程序必須通過單元測試。

5.?可重用性要求
5.1?重復使用的完成相對獨立功能的算法或代碼應抽象為公共控件或類。
5.2?公共控件或類應考慮OO思想，減少外界聯(lián)系，考慮獨立性或封裝性。
5.3?公共控件或類應建立使用模板。
　　　　　　　　　?附：C＋＋?編程規(guī)范,delphi作相應的參考

1適用范圍
本標準適用于利用Visul?C++?,Borland?C++進行軟件程序開發(fā)的人員.。

.2變量命名
命名必須具有一定的實際意義,形式為xAbcFgh,x由變量類型確定,Abc、Fgh表示連續(xù)意
義字符串,如果連續(xù)意義字符串僅兩個,可都大寫.如OK.
具體例程:
BOOL類型　　　　　　　　?bEnable;

ch　　?*　　　　　　?char　　　　　　　　　　　　　?chText
c　　?*　　　　　　?類對象　　　　　　　　　　　　?cMain（對象實例）
h　　?*　　　　　　?Handle（句柄）　　　　　　　　?hWnd
i　　?*　　　　　　?int
n　　?*　　　　　　?無符號整型
p　　?*　　　　　　?指針
sz,str?*　　　　　　?字符串
w　　　　　　　　　　?WORD
x,y　　　　　　　　　?坐標
Char或者TCHAR類型　　　?與Windows?API有直接聯(lián)系的用szAppName[10]形式否則用
FileName[10]形式,單個字符也可用小寫字母表示;
Int類型　　　　　　　　　?nCmdShow;
LONG類型　　　　　　　　?lParam;
UINT類型　　　　　　　　?uNotify;
DWORD類型　　　　　　　?dwStart;
PSTR類型　　　　　　　　?pszTip;
LPSTR類型　　　　　　　?lpCmdLine
LPTSTR類型　　　　　　　?lpszClassName;
LPVOID類型　　　　　　　?lpReserved
WPARAM類型　　　　　　?wParam,
LPARAM類型　　　　　　　?lParam
HWND類型　　　　　　　　?hDlg;
HDC類型　　　　　　　　　?hDC;
HINSTANCE類型　　　　　?hInstance
HANDLE類型　　　　　　　?hInstance,
HICON類型　　　　　　　　?hIcon;
int　　　　　　　　　　　　?iTmp
float　　　　　　　　　　　　?fTmp
DWORD　　　　　　　　　?dw*
String?,?AnsiString　　　　　　?str?*
m_　　　　　　　　　　?類成員變量　　　　　　　　　　?m_nVal,?m_bFlag
g_　　　　　　　　　　?全局變量　　　　　　　　　　　?g_nMsg,?g_bFlag
局部變量中可采用如下幾個通用變量：nTemp，nResult，I，J（一般用于循環(huán)變量）。
其他資源句柄同上
.3常量命名和宏定義
常量和宏定義必須具有一定的實際意義;
常量和宏定義在#include和函數(shù)定義之間;
常量和宏定義必須全部以大寫字母來撰寫,中間可根據(jù)意義的連續(xù)性用下劃線連接,每一
條定義的右側(cè)必須有一簡單的注釋,說明其作用;
資源名字定義格式:
菜單:IDM_XX或者CM_XX
位圖:IDB_XX
對話框:IDD_XX
字符串:IDS_XX
DLGINIT:DIALOG_XX
　ICON:IDR_XX
.4函數(shù)命名
函數(shù)原型說明包括引用外來函數(shù)及內(nèi)部函數(shù)，外部引用必須在右側(cè)注明函數(shù)來源：模
塊名及文件名,?如是內(nèi)部函數(shù)，只要注釋其定義文件名;
第一個字母必須使用大寫字母,要求用大小寫字母組合規(guī)范函數(shù)命名,必要時可用下劃線
間隔,示例如下：
void　UpdateDB_Tfgd?(TRACK_NAME);　?file://Module　Name?:r01/sdw.c
void　PrintTrackData?(TRACK_NAME);?file://Module?Name?:r04/tern.c
void　ImportantPoint?(void);　　　　　?file://Module　Name?:r01/sdw.c
void　ShowChar?(int?,?int?,?chtype);　?file://Local?Module
void　ScrollUp_V　(int?,?int);　　　　　?file://Local?Module
.5結(jié)構(gòu)體命名
結(jié)構(gòu)體類型命名必須全部用大寫字母,原則上前面以下劃線開始;結(jié)構(gòu)體變量命名必須用
大小寫字母組合，第一個字母必須使用大寫字母,必要時可用下劃線間隔。對于私有數(shù)
據(jù)區(qū)，必須注明其所屬的進程。全局數(shù)據(jù)定義只需注意其用途。
　　　　　　　　　?示例如下：
　　　　　　　　　?typedef?struct
　　　　　　　　　?{
　　　　　　　　　　　　　?char?　　　　　　　?szProductName[20];
　　　　　　　　　　　　　?char?　　　　　　　?szAuthor[20];

　　　　　　　　　　　　　?char?　　　　　　　?szReleaseDate[16];
　　　　　　　　　　　　　?char?　　　　　　　?szVersion[10];
　　　　　　　　　　　　　?unsigned?long　　　?MaxTables;
　　　　　　　　　　　　　?unsigned?long　　　?UsedTables;
}DBS_DATABASE;
DBS_DATABASE?GdataBase;

6?控件的命名：
用小寫前綴表示類別
用小寫前綴表示類別：
fm　　　　　　?窗口
cmd　　　　　?按鈕
cob　　　　　?combo，下拉式列表框
txt　　　　　?文本輸入框
lab　　　　　?labal，標簽
img　　　　　?image，圖象
pic　　　　　?picture
grd　　　　　?Grid，網(wǎng)格
scr　　　　　?滾動條
lst　　　　　?列表框
frm　　　　　?fram

7注釋
原則上注釋要求使用中文;
文件開始注釋內(nèi)容包括:公司名稱、版權(quán)、作者名稱、時間、模塊用途、背景介紹等,復
雜的算法需要加上流程說明;
函數(shù)注釋包括:輸入、輸出、函數(shù)描述、流程處理、全局變量、調(diào)用樣例等,復雜的函數(shù)
需要加上變量用途說明;
程序中注釋包括:修改時間和作者、方便理解的注釋等;


　　引用一:?文件開頭的注釋模板
/******************************************************************
**?文件名:
**?Copyright?(c)?1998-1999?*********公司技術(shù)開發(fā)部
**?創(chuàng)建人:
**?日　期:
**?修改人:
**?日　期:
**?描　述:
**
**?版　本:
**--------------------------------------------------------------------------
---


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

　　引用二:?函數(shù)開頭的注釋模板
/*****************************************************************
**?函數(shù)名:
**?輸　入:?a,b,c
**　　?a---
**　　?b---
**　　?c---
**?輸　出:?x---
**　　　x?為?1,?表示...
**　　　x?為?0,?表示...
**?功能描述:
**?全局變量:
**?調(diào)用模塊:
**?作　者:
**?日　期:
**?修　改:
**?日　期:
**?版本
****************************************************************/
　　引用三:?程序中的注釋模板
/*----------------------------------------------------------*/
/*?注釋內(nèi)容　　　　　　　　　　　?*/
/*----------------------------------------------------------*/
8?程序
a.　　?程序編碼力求簡潔，結(jié)構(gòu)清晰，避免太多的分支結(jié)構(gòu)及太過于技巧性的程序，
盡量不采用遞歸模式。
b.　?編寫程序時，亦必須想好測試的方法，換句話說，”單元測試”?的測試方案應
在程序編寫時一并擬好。
c.　?注釋一定要與程序一致。
d.　?版本封存以后的修改一定要將老語句用/*?*/?封閉，不能自行刪除或修改,并要
在文件及函數(shù)的修改記錄中加以記錄。
e.　　?程序中每個block?的開頭?”{"?及?"}”?必須對齊，嵌套的block?每進一套，
縮進一個tab，TAB?為4個空格,block類型包括if、for、while、do等關(guān)鍵字引出的。
f.　對于比較大的函數(shù)，每個block?和特殊的函數(shù)調(diào)用，都必須注明其功能，舉例如下
：
count.divisor?=?1193280?/?freq;　　　　　　　?//　compute?the?proper?count
OutByte((unsigned?short)67,?(unsigned?char)182);　//　tell?8253?that?a
count?is?coming
OutByte((unsigned?short)66,?count.?c[0]);　　　//　send?low-order?byte
OutByte((unsigned?short)66,?count.?c[1]);　　　//　send?high-order?byte

×××××××××××××××××××××××××××××××××××××××
bcb，delphi中的變量命名：
　遵循匈牙利命名法，命
名必須有意義，制定如下規(guī)定
　窗體：以大寫的W開始，如About版權(quán)窗體，?命名為WAbout
文件：以大寫的F開始，如About版權(quán)窗體，文件命名為FAbout.cpp
按鈕(Button)：如退出按鈕，命名為btnExit
　……
　基類：加base標記，如報表基類,窗體命名為：WBaseRep,?文件命名為FBaseRep.cpp

轉(zhuǎn)貼
>?1.?在.h/.cpp的開頭應有一段格式統(tǒng)一的說明，內(nèi)容包括：
>?a.?文件名?(FileName)；
>?b.?創(chuàng)建人?(Creater)；
>?c.?文件創(chuàng)建時間?(Date)；
>?d.?簡短說明文件功能、用途?(Comment)。
好習慣
>?2.?除非極其簡單，否則對函數(shù)應有注釋說明。內(nèi)容包括：功能、入口/出口參數(shù)，必
要
>?時還可有備注或補充說明。
還是好習慣
>?3.?每列代碼的長度推薦為?80列，最長不得超過120列；折行以對齊為準。
太寬了，我的限制是60列，因為文本方式下屏幕一共80列，如果你用BC這一類的編輯
器，窗口邊框等又要占據(jù)一定空間，所以80列太寬
>?4.?循環(huán)、分支代碼，判斷條件與執(zhí)行代碼不得在同一行上。
很對
>?5.?指針的定義，*?號既可以緊接類型，也可以在變量名之前。
>
>?例：可寫做：int*　pnsize;
>
>?也可寫做：int　*pnsize;
>
>?但不得寫做：int　*　pnsize;
建議采用第二種，除非附加另外一條規(guī)定：一次只聲明一個變量，否則就會讓人混淆，
比如：
int*?a,?b;
看起來b好像也是個指針，其實不是。
>?6.?在類的成員函數(shù)內(nèi)調(diào)用非成員函數(shù)時，在非成員函數(shù)名前必須加上"::"。
這一條我倒覺得并不是必需的，我的看法是決不要讓你的類成員函數(shù)和全局函數(shù)的名稱
相同（或類似）
>?7.?函數(shù)入口參數(shù)有缺省值時，應注釋說明。
>
>?例：BOOL?CWpsDib::PaintDIB(CDC*?pDC,?CRect&?rc,
>　　　int?nBrightness,?file://*=0*//
>　　　BOOL?bGrayScale?file://*=FALSE*//?)
每個變量寫一行，必要時加上/*in,?out*/注釋
>?8.?else　if?必須寫在一行。
應該盡量避免else?if這樣的結(jié)構(gòu)
>?9.?與‘{’、‘}’有關(guān)的各項規(guī)定：
>
>　9.1‘{’、‘}’應獨占一行。在該行內(nèi)可有注釋。
>?9.2?‘{’必須另起一行，‘{’?之后的代碼必須縮進一個Tab。‘{’與‘}’必須在
同
>?一列上。
>?9.3?在循環(huán)、分支之后若只有一行代碼，雖然可省略‘{’、‘}’，但不推薦這么
>?做。若省略后可能引起歧義，則必須加上‘{’、‘}’。
持保留意見，因為GNU的代碼規(guī)范是這樣的：
if?(?NULL?==?ptr?)
　　{
　　　　//?do?something?here
　　}
或者
if?(?NULL?==?ptr?)?{
　　　　//?do?something?here
}
爭論哪個更好并沒有意義，關(guān)鍵是統(tǒng)一，如果用VC當然你的辦法最方便，可是如果你用
emacs或者vi，就不是這樣了。
>?10.?與空格有關(guān)的各項規(guī)定。
>
>?10.1?在所有兩目、三目運算符的兩邊都必須有空格。在單目運算符兩端不必空格。
但
>?在‘—>’、‘::’、‘.’、‘[’、‘]’等運算符前后，及‘&’（取地址）、‘*
>?’（取值）等運算符之后不得有空格。
>?10.2　for、while、if?等關(guān)鍵詞之后應有1個空格，再接‘(’，之后無空格；在結(jié)
尾
>?的‘)’前不得有空格。

我認為在括號兩端加空格并不是什么錯誤，尤其是在一個條件十分復雜的if語句里
>?10.3?調(diào)用函數(shù)、宏時，‘(’、‘)’前后不得有空格。
>?10.4　類型強制轉(zhuǎn)換時，‘(’‘)’前后不得有空格
同上
>?11.?與縮進有關(guān)的各項規(guī)定
>
>?11.1?縮進以?Tab?為單位。1?個?Tab?為?4?個空格
我認為這個值應該更大，我自己使用8個空格，如果你的代碼因為縮進幅度太大而導致
折行，那么幾乎可以肯定你的程序設(shè)計方案有問題。
>?11.2?下列情況，代碼縮進一個?Tab:
>?1.?函數(shù)體相對函數(shù)名及'{'、'}'。
>?2.?if、else、for、while、do?等之后的代碼。
>?3.?一行之內(nèi)寫不下，折行之后的代碼，應在合理的位置進行折行。若有?+?-?*?/?等
運
>?算符，則運算符應在上一行末尾，而不應在下一行的行首。
這一條我反對，運算符應該放在下一行行首，以使人能清楚的知道這一行是續(xù)上一行
的，比如
if?(?something
　　&&?somethingelse
　　&&?otherthings?)
如果寫做
if?(?something?&&
　　somethingelse?&&
　　otherthings?)
反而看不清楚
>?11.3?下列情況，不必縮進：switch?之后的?case、default。