1.關(guān)鍵詞和操作符之間加適當?shù)目崭瘛?br />2.相對獨立的程序塊與塊之間加空行
3.較長的語句、表達式等要分成多行書寫。
4.劃分出的新行要進行適應的縮進,使排版整齊,語句可讀。
5.長表達式要在低優(yōu)先級操作符處劃分新行,操作符放在新行之首。
6.循環(huán)、判斷等語句中若有較長的表達式或語句,則要進行適應的劃分。
7.若函數(shù)或過程中的參數(shù)較長,則要進行適當?shù)膭澐帧?br />8.不允許把多個短語句寫在一行中,即一行只寫一條語句。
9.函數(shù)或過程的開始、結(jié)構(gòu)的定義及循環(huán)、判斷等語句中的代碼都要采用縮進風格。
10.C/C++語言是用大括號‘{’和‘}’界定一段程序塊的,編寫程序塊時‘{’和
‘}’應各獨占一行并且位于同一列,同時與引用它們的語句左對齊。在函數(shù)體
的開始、類的定義、結(jié)構(gòu)的定義、枚舉的定義以及if、for、do、while、
switch、case語句中的程序都要采用如上的縮進方式。
1.注釋要簡單明了。
2.邊寫代碼邊注釋,修改代碼同時修改相應的注釋,以保證注釋與代碼的一致性。
3.在必要的地方注釋,注釋量要適中。注釋的內(nèi)容要清楚、明了,含義準確,防止
注釋二義性。保持注釋與其描述的代碼相鄰,即注釋的就近原則。
4.對代碼的注釋應放在其上方相鄰位置,不可放在下面。
5.對數(shù)據(jù)結(jié)構(gòu)的注釋應放在其上方相鄰位置,不可放在下面;對結(jié)構(gòu)中的每個域
的注釋應放在此域的右方;同一結(jié)構(gòu)中不同域的注釋要對齊。
6.變量、常量的注釋應放在其上方相鄰位置或右方。
7.全局變量要有較詳細的注釋,包括對其功能、取值范圍、哪些函數(shù)或過程存取它
以及存取時注意事項等的說明。
8.在每個源文件的頭部要有必要的注釋信息,包括:文件名;版本號;作者;生成
日期;模塊功能描述(如功能、主要算法、內(nèi)部各部分之間的關(guān)系、該文件與其
它文件關(guān)系等);主要函數(shù)或過程清單及本文件歷史修改記錄等。
9.在每個函數(shù)或過程的前面要有必要的注釋信息,包括:函數(shù)或過程名稱;功能描
述;輸入、輸出及返回值說明;調(diào)用關(guān)系及被調(diào)用關(guān)系說明等。
1.較短的單詞可通過去掉“元音”形成縮寫;
2.較長的單詞可取單詞的頭幾發(fā)符的優(yōu)先級,并用括號明確表達式的操作順序,避
免使用默認優(yōu)先級。
3.使用匈牙利表示法
1.避免使用不易理解的數(shù)字,用有意義的標識來替代。
2.不要使用難懂的技巧性很高的語句。
3.源程序中關(guān)系較為緊密的代碼應盡可能相鄰。
1.去掉沒必要的公共變量。
2.構(gòu)造僅有一個模塊或函數(shù)可以修改、創(chuàng)建,而其余有關(guān)模塊或函數(shù)只訪問的公共
變量,防止多個不同模塊或函數(shù)都可以修改、創(chuàng)建同一公共變量的現(xiàn)象。
3.仔細定義并明確公共變量的含義、作用、取值范圍及公共變量間的關(guān)系。
4.明確公共變量與操作此公共變量的函數(shù)或過程的關(guān)系,如訪問、修改及創(chuàng)建等。
5.當向公共變量傳遞數(shù)據(jù)時,要十分小心,防止賦與不合理的值或越界等現(xiàn)象發(fā)生。
6.防止局部變量與公共變量同名。
7.仔細設計結(jié)構(gòu)中元素的布局與排列順序,使結(jié)構(gòu)容易理解、節(jié)省占用空間,并減