序號總
則 條 款
執行情況
說明
1 排版
1 ¹ 1-1:程序塊要採用縮進風格編寫,縮進的空格數爲4個。
2 ¹ 1-2:相對獨立的程序塊之間、變量說明之後必須加空行。
3 ¹ 1-3:較長的語句(>80字符)要分成多行書寫,長表達式要在低優先級操作符處劃分新行,操作符放在新行之首,劃分出的新行要進行適當的縮進,使排版整齊,語句可讀。
4 ¹ 1-4:循環、判斷等語句中若有較長的表達式或語句,則要進行適應的劃分,長表達式要在低優先級操作符處劃分新行,操作符放在新行之首。
5 ¹ 1-5:若函數或過程中的參數較長,則要進行適當的劃分。
6 ¹ 1-6:不允許把多個短語句寫在一行中,即一行只寫一條語句。
7 ¹ 1-7:if、while、for、default、do等語句自佔一行。
8 ¹ 1-8:對齊只使用空格鍵,不使用TAB鍵。
9 ¹ 1-9:函數或過程的開始、結構的定義及循環、判斷等語句中的代碼都要採用縮進風格,case語句下的情況處理語句也要遵從語句縮進要求。
10 ¹ 1-10:程序塊的分界符(如C/C++語言的大括號‘{’和‘}’)應各獨佔一行並且位於同一列,同時與引用它們的語句左對齊。在函數體的開始、類的定義、結構的定義、枚舉的定義以及if、for、do、while0、switch、case語句中的程序都要採用如上的縮進方式。
11 ¹ 1-11:在兩個以上的關鍵字、變量、常量進行對等操作時,它們之間的操作符之前、之後或者前後要加空格;進行非對等操作時,如果是關係密切的立即操作符(如->),後不應加空格。
2
註釋
¹ 2-1:一般情況下,源程序有效註釋量必須在20%以上。
¹ 2-2:說明性文件(如頭文件.h文件、.inc文件、.def文件、編譯說明文件.cfg等)頭部應進行註釋,註釋必須列出:版權說明、版本號、生成日期、作者、內容、功能、與其它文件的關係、修改日誌等,頭文件的註釋中還應有函數功能簡要說明。
¹ 2-3:源文件頭部應進行註釋,列出:版權說明、版本號、生成日期、作者、模塊目的/功能、主要函數及其功能、修改日誌等。
¹ 2-4:函數頭部應進行註釋,列出:函數的目的/功能、輸入參數、輸出參數、返回值、調用關係(函數、表)等。
¹ 2-5:邊寫代碼邊註釋,修改代碼同時修改相應的註釋,以保證註釋與代碼的一致性。不再有用的註釋要刪除。
¹ 2-6:註釋的內容要清楚、明瞭,含義準確,防止註釋二義性。
¹ 2-7:避免在註釋中使用縮寫,特別是非常用縮寫。
¹ 2-8:註釋應與其描述的代碼相近,對代碼的註釋應放在其上方或右方(對單條語句的註釋)相鄰位置,不可放在下面,如放於上方則需與其上面的代碼用空行隔開。
¹2-9:對於所有有物理含義的變量、常量,如果其命名不是充分自注釋的,在聲明時都必須加以註釋,說明其物理含義。變量、常量、宏的註釋應放在其上方相鄰位置或右方。
¹
2-10:數據結構聲明(包括數組、結構、類、枚舉等),如果其命名不是充分自注釋的,必須加以註釋。對數據結構的註釋應放在其上方相鄰位置,不可放在下面;對結構中的每個域的註釋放在此域的右方。
¹ 2-11:全局變量要有較詳細的註釋,包括對其功能、取值範圍、哪些函數或過程存取它以及存取時注意事項等的說明。
¹ 2-12:註釋與所描述內容進行同樣的縮排。
¹
2-13:將註釋與其上面的代碼用空行隔開。
¹ 2-14:對變量的定義和分支語句(條件分支、循環語句等)必須編寫註釋。
¹ 2-15:對於switch語句下的case語句,如果因爲特殊情況需要處理完一個case後進入下一個case處理,必須在該case語句處理完、下一個case語句前加上明確的註釋。
3 標識符命名
¹ 3-1:標識符的命名要清晰、明瞭,有明確含義,同時使用完整的單詞或大家基本可以理解的縮寫,避免使人產生誤解。
¹ 3-2:命名中若使用特殊約定或縮寫,則要有註釋說明。
¹ 3-3:自己特有的命名風格,要自始至終保持一致,不可來回變化。
¹ 3-4:對於變量命名,禁止取單個字符(如i、j、k...),建議除了要有具體含義外,還能表明其變量類型、數據類型等,但i、j、k作局部循環變量是允許的。
¹ 3-5:命名規範必須與所使用的系統風格保持一致,並在同一項目中統一,比如採用UNIX的全小寫加下劃線的風格或大小寫混排的方式,不要使用大小寫與下劃線混排的方式。
4
可讀性
¹ 4-1:注意運算符的優先級,並用括號明確表達式的操作順序,避免使用默認優先級。
¹ 4-2:避免使用不易理解的數字,用有意義的標識來替代。涉及物理狀態或者含有物理意義的常量,不應直接使用數字,必須用有意義的枚舉或宏來代替。
5
變量
¹ 5-1:去掉沒必要的公共變量。
¹ 5-2:仔細定義並明確公共變量的含義、作用、取值範圍及公共變量間的關係。
¹ 5-3:明確公共變量與操作此公共變量的函數或過程的關係,如訪問、修改及創建等。
¹ 5-4:當向公共變量傳遞數據時,要十分小心,防止賦與不合理的值或越界等現象發生。
¹ 5-5:防止局部變量與公共變量同名。
¹ 5-6:嚴禁使用未經初始化的變量作爲右值。
6 函數、過程
¹ 6-1:對所調用函數的錯誤返回碼要仔細、全面地處理。
¹ 6-2:明確函數功能,精確(而不是近似)地實現函數設計。
¹
6-3:編寫可重入函數時,應注意局部變量的使用(如編寫C/C++語言的可重入函數時,應使用auto即缺省態局部變量或寄存器變量)。
¹ 6-4:編寫可重入函數時,若使用全局變量,則應通過關中斷、信號量(即P、V操作)等手段對其加以保護。
7 可測性
¹ 7-1:在同一項目組或產品組內,要有一套統一的爲集成測試與系統聯調準備的調測開關及相應打印函數,並且要有詳細的說明。
¹ 7-2:在同一項目組或產品組內,調測打印出的信息串的格式要有統一的形式。信息串中至少要有所在模塊名(或源文件名)及行號。
¹ 7-3:編程的同時要爲單元測試選擇恰當的測試點,並仔細構造測試代碼、測試用例,同時給出明確的註釋說明。測試代碼部分應作爲(模塊中的)一個子模塊,以方便測試代碼在模塊中的安裝與拆卸(通過調測開關)。
¹
7-4:在進行集成測試/系統聯調之前,要構造好測試環境、測試項目及測試用例,同時仔細分析並優化測試用例,以提高測試效率。
¹ 7-5:使用斷言來發現軟件問題,提高代碼可測性。
¹ 7-6:用斷言來檢查程序正常運行時不應發生但在調測時有可能發生的非法情況。
¹ 7-7:不能用斷言來檢查最終產品肯定會出現且必須處理的錯誤情況。
¹ 7-8:對較複雜的斷言加上明確的註釋。
¹ 7-9:用斷言確認函數的參數。
¹ 7-10:用斷言保證沒有定義的特性或功能不被使用。
¹ 7-11:用斷言對程序開發環境(OS/Compiler/Hardware)的假設進行檢查。
¹ 7-12:正式軟件產品中應把斷言及其它調測代碼去掉(即把有關的調測開關關掉)。
¹
7-13:在軟件系統中設置與取消有關測試手段,不能對軟件實現的功能等產生影響。
¹ 7-14:用調測開關來切換軟件的DEBUG版和正式版,而不要同時存在正式版本和DEBUG版本的不同源文件,以減少維護的難度。
¹ 7-15:軟件的DEBUG版本和發行版本應該統一維護,不允許分家,並且要時刻注意保證兩個版本在實現功能上的一致性。
8 程序效率
¹ 8-1:編程時要經常注意代碼的效率。
¹ 8-2:在保證軟件系統的正確性、穩定性、可讀性及可測性的前提下,提高代碼效率。
¹ 8-3:局部效率應爲全局效率服務,不能因爲提高局部效率而對全局效率造成影響。
¹
8-4:通過對系統數據結構的劃分與組織的改進,以及對程序算法的優化來提高空間效率。
¹ 8-5:循環體內工作量最小化。
9
質量保證
¹ 9-1:在軟件設計過程中構築軟件質量。
¹ 9-2:代碼質量保證優先原則
¹ 9-3:只引用屬於自己的存貯空間。
¹
9-4:防止引用已經釋放的內存空間。
¹ 9-5:過程/函數中分配的內存,在過程/函數退出之前要釋放。
¹ 9-6:過程/函數中申請的(爲打開文件而使用的)文件句柄,在過程/函數退出之前要關閉。
¹
9-7:防止內存操作越界。
¹ 9-8:認真處理程序所能遇到的各種出錯情況。
¹ 9-9:系統運行之初,要初始化有關變量及運行環境,防止未經初始化的變量被引用。
¹ 9-10:系統運行之初,要對加載到系統中的數據進行一致性檢查。
¹
9-11:嚴禁隨意更改其它模塊或系統的有關設置和配置。
¹ 9-12:不能隨意改變與其它模塊的接口。
¹ 9-13:充分了解系統的接口之後,再使用系統提供的功能。
¹
9-14:編程時,要防止差1錯誤。
¹ 9-15:要時刻注意易混淆的操作符。當編完程序後,應從頭至尾檢查一遍這些操作符,以防止拼寫錯誤。
¹ 9-16:有可能的話,if語句儘量加上else分支,對沒有else分支的語句要小心對待;switch語句必須有default分支。
10 代碼編輯、編譯、審查
¹ 10-1:打開編譯器的所有告警開關對程序進行編譯。
¹ 10-2:在產品軟件(項目組)中,要統一編譯開關選項。
¹ 10-3:通過代碼走讀及審查方式對代碼進行檢查。
¹ 10-4:測試部測試產品之前,應對代碼進行抽查及評審。
11 代碼測試、維護
¹ 11-1:單元測試要求至少達到語句覆蓋。
¹ 11-2:單元測試開始要跟蹤每一條語句,並觀察數據流及變量的變化。
¹
11-3:清理、整理或優化後的代碼要經過審查及測試。
¹ 11-4:代碼版本升級要經過嚴格測試。
¹ 11-5:使用工具軟件對代碼版本進行維護。
¹ 11-6:正式版本上軟件的任何修改都應有詳細的文檔記錄。
12 宏
¹ 12-1:用宏定義表達式時,要使用完備的括號。
¹ 12-2:將宏所定義的多條表達式放在大括號中。
¹ 12-3:使用宏時,不允許參數發生變化。