【正文】 量類型＋變量英文意思(或縮寫)變量類型請(qǐng)參見附表1－變量類型表；☆ 標(biāo)識(shí)符最好采用英文單詞或其組合，便于記憶和閱讀，切忌使用漢語拼音來命名，程序中的英文單詞一般不要太復(fù)雜，用詞應(yīng)當(dāng)準(zhǔn)確，例如不要把CurrentValue寫成NowValue； 【】 程序中不要出現(xiàn)僅靠大小寫區(qū)分的相似的標(biāo)識(shí)符。 maxinformation”原則；☆ 【】 標(biāo)識(shí)符應(yīng)當(dāng)直觀且可以拼讀，可望文知意，不必進(jìn)行“解碼”；☆ // 前綴 f表示float類型 如此煩瑣的程序會(huì)讓絕大多數(shù)程序員無法忍受。 “匈牙利”法最大的缺點(diǎn)是煩瑣，例如 int i, j, k。為了加強(qiáng)信息隱藏，這些私有的頭文件可以和定義文件存放于同一個(gè)目錄。如果某個(gè)接口被實(shí)現(xiàn)或被使用時(shí)，其方式與頭文件中的聲明不一致，編譯器就會(huì)指出錯(cuò)誤，這一簡(jiǎn)單的規(guī)則能大大減輕程序員調(diào)試、改錯(cuò)的負(fù)擔(dān)。這里對(duì)頭文件的作用略作解釋： （1） 通過頭文件來調(diào)用庫功能。//文件信息聲明見示例31，此處省略。 定義文件開頭處的文件信息聲明(參見示例31)；(2)endif示例32 C++/C頭文件的結(jié)構(gòu)頭文件的結(jié)構(gòu)如下：//文件信息聲明見示例31，此處省略。 頭文件的結(jié)構(gòu)頭文件由三部分內(nèi)容組成： (1) 【】 文件信息聲明包含五個(gè)部分，各部分之間以一空行間隔；☆////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// Copyright (c) 2015, DeLianSoftCompany YanTai// All rights reserved.//// Filename ：// Project Code ：The project code about this file// Abstract ：Describe the content of this file summarily// Reference ：......//// Version ：// Author ：the name of author(mender)// Acplished date ： September 2, 2004//// Replaced version : // Original Author : the name of original author(mender)// Acplished date : September 10, 2003//// Main functions ：// Function 1 Return code Function name(Parameter Explain)// Function 2 Return code Function name(Parameter Explain)// ...// Function n Return code Function name(Parameter Explain)////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////示例31 文件信息聲明☆ 版本歷史信息；（5） 文件名稱，項(xiàng)目代碼，摘要，參考文獻(xiàn)；（3） 文件信息聲明文件信息聲明位于頭文件和定義文件的開頭（參見示例31），主要內(nèi)容有：（1） 文件結(jié)構(gòu) 每個(gè)C++/C程序通常分為兩個(gè)文件。若研究項(xiàng)目小組的所有開發(fā)人員都遵循統(tǒng)一的、鮮明的一套編程風(fēng)格，可以讓協(xié)作者、后繼者和自己一目了然，在很短的時(shí)間內(nèi)看清楚程序結(jié)構(gòu)，理解設(shè)計(jì)的思路，大大提高代碼的可讀性、可重用性、程序健壯性、可移植性、可維護(hù)性。圖3 圖書管理系統(tǒng)模塊規(guī)劃圖舉例 系統(tǒng)功能開發(fā)流程圖給出系統(tǒng)主要功能的業(yè)務(wù)流程圖。明確整個(gè)系統(tǒng)開發(fā)工作流程，至少應(yīng)該包括以下流程。本規(guī)范為煙臺(tái)開發(fā)區(qū)德聯(lián)軟件有限責(zé)任公司內(nèi)部材料，嚴(yán)禁其他商業(yè)應(yīng)用。軟件開發(fā)流程規(guī)范德聯(lián)軟件有限責(zé)任公司編制人： 侯秀美 審核人： 2015 年 8 月 19 日目錄目錄 0一、概述 2二、開發(fā)流程規(guī)范 3 系統(tǒng)軟硬件開發(fā)環(huán)境 3 系統(tǒng)架構(gòu)（系統(tǒng)組成） 5 系統(tǒng)功能模塊設(shè)計(jì) 6 系統(tǒng)功能開發(fā)流程圖 6 開發(fā)修改記錄 7三、開發(fā)代碼規(guī)范 8 文件結(jié)構(gòu) 8 文件信息聲明 8 頭文件的結(jié)構(gòu) 10 定義文件的結(jié)構(gòu) 11 頭文件的作用 12 目錄結(jié)構(gòu) 13 命名規(guī)則 13 共性原則 13 Windows變量命名規(guī)則 14 程序風(fēng)格 16 空行 17 代碼行 18 代碼行內(nèi)的空格 19 對(duì)齊 20 長(zhǎng)行拆分 22 修飾符的位置 23 注釋 23 函數(shù)設(shè)計(jì) 26 參數(shù)的規(guī)則 26 返回值的規(guī)則 27 函數(shù)內(nèi)部實(shí)現(xiàn)的規(guī)則 30 其它建議 32 使用斷言 32 引用與指針的比較 33 變量類型定義 35四、軟件測(cè)試規(guī)范 36 單元測(cè)試 36 系統(tǒng)測(cè)試 37 業(yè)務(wù)測(cè)試 38 驗(yàn)收測(cè)試 38 用戶現(xiàn)場(chǎng)測(cè)試 38五、軟件版本管理 39 39一、概述本文制定煙臺(tái)開發(fā)區(qū)德聯(lián)軟件有限責(zé)任公司計(jì)算機(jī)軟件開發(fā)規(guī)范文檔。二、開發(fā)流程規(guī)范 接受開發(fā)任務(wù)，詳細(xì)閱讀軟件技術(shù)規(guī)范或技術(shù)文檔，如對(duì)技術(shù)文檔有疑義或者不清楚的地方及時(shí)與項(xiàng)目總工或用戶溝通，根據(jù)文檔和溝通內(nèi)容編寫項(xiàng)目開發(fā)計(jì)劃，必須包括但不限于系統(tǒng)軟硬件開發(fā)環(huán)境、系統(tǒng)架構(gòu)、系統(tǒng)功能模塊設(shè)計(jì)、系統(tǒng)功能開發(fā)流程圖、開發(fā)修改記錄。 系統(tǒng)架構(gòu)（系統(tǒng)組成）確定系統(tǒng)整體體系架構(gòu)，各層次之間的數(shù)據(jù)流的連接，確定軟件服務(wù)器的硬件配置及用戶硬件資源配置， 確定與用戶軟件平臺(tái)的統(tǒng)一協(xié)調(diào)。圖4 系統(tǒng)功能業(yè)務(wù)流程圖舉例 開發(fā)修改記錄1. 開發(fā)代碼做好備份（可以在完成一個(gè)重大功能之后，或者按時(shí)間周期性進(jìn)行備份），以免由于不可抗力導(dǎo)致代碼不可修復(fù)。 制定本編程規(guī)范的目的是為了提高軟件開發(fā)效率及所開發(fā)軟件的可維護(hù)性，提高軟件的質(zhì)量。一個(gè)文件用于保存程序的聲明（declaration），稱為頭文件。 函數(shù)和類結(jié)構(gòu)聲明等。 【】 為了防止頭文件被重復(fù)引用，應(yīng)當(dāng)用ifndef/define/endif結(jié)構(gòu)產(chǎn)生預(yù)處理塊；“ifndef”或者“define”后以TAB鍵代替SPACE鍵做空格；如果頭文件名稱是由多個(gè)單詞組成，則各單詞間以下劃線“_”連接，例如有頭文件名稱為“”，則定義如下：“ifndef _FILE_SYSTEM_H_”；☆ 【】 用 include “” 格式來引用非標(biāo)準(zhǔn)庫的頭文件(編譯器將從用戶的工作目錄開始搜索)；☆ 【】 頭文件中應(yīng)包含所有定義文件所定義的函數(shù)聲明，如果一個(gè)頭文件對(duì)應(yīng)多個(gè)定義文件，則不同定義文件內(nèi)實(shí)現(xiàn)的函數(shù)要分開聲明，并作注釋以解釋所聲明的函數(shù)從屬于那一個(gè)定義文件；☆ 【】 在C++ 語法中，類的成員函數(shù)可以在聲明的同時(shí)被定義，并且自動(dòng)成為內(nèi)聯(lián)函數(shù)。 定義文件的結(jié)構(gòu)定義文件有三部分內(nèi)容：(1)在很多場(chǎng)合，源代碼不便（或不準(zhǔn)）向用戶公布，只要向用戶提供頭文件和二進(jìn)制的庫即可。 目錄結(jié)構(gòu) 如果一個(gè)軟件的頭文件數(shù)目比較多（如超過十個(gè)），通常應(yīng)將頭文件和定義文件分別保存于不同的目錄，以便于維護(hù)。 命名規(guī)則 比較著名的命名規(guī)則當(dāng)推“匈牙利” 命名法，該命名規(guī)則的主要思想是“在變量和函數(shù)名中加入前綴以增進(jìn)人們對(duì)程序的理解”。 float x, y, z。 總的說來，沒有一種命名規(guī)則可以讓所有的程序員贊同，且命名規(guī)則對(duì)軟件產(chǎn)品而言并不是“成敗悠關(guān)”的事，而且在不同的平臺(tái)和不同的環(huán)境下編寫的程序所應(yīng)遵循的規(guī)則也不盡相同，所以我們只是追求制定一種令大多數(shù)項(xiàng)目成員滿意的命名規(guī)則，并在項(xiàng)目中貫徹實(shí)施?！?【】 變量的名字應(yīng)當(dāng)使用“名詞”或者“形容詞＋名詞”；☆ 【】 用正確的反義詞組命名具有互斥意義的變量或相反動(dòng)作的函數(shù)等；☆ 標(biāo)示符的長(zhǎng)度應(yīng)當(dāng)以最小的長(zhǎng)度實(shí)現(xiàn)最多信息，一般來說，長(zhǎng)名字能更好地表達(dá)含義，但并非長(zhǎng)的變量名就一定要比短的變量名要好，此外單字符的名字也是有用的，常見的如i,j,k,m,n,x,y,z等，它們通常可用作函數(shù)內(nèi)的局部變量；union URecordLen{ BYTE m_byRecordNum。 EMDAYS_TUESDAY。 空行空行起著分隔程序段落的作用。 【】 在一個(gè)函數(shù)體內(nèi)，邏揖上密切相關(guān)的語句之間不加空行，其它地方應(yīng)加空行分隔。 // blank line if (condition) { statement2。 代碼行☆ 【】 if、for、while、do等語句自占一行，執(zhí)行語句不得緊跟其后，不論執(zhí)行語句有多少都要加{}，這樣可以防止書寫失誤；☆ 【】 所有函數(shù)內(nèi)的變量都在函數(shù)開始處定義；☆(a)為風(fēng)格良好的代碼行，(b)為風(fēng)格不良的代碼行。 // widthint nHeight。//width,height,depthX ＝ a + b。if (nWidth nHight) { DoSomething()。 update){DoSomething()。 condition?！蚯熬o跟，緊跟處不留空格；☆ condition。amp?！保ǖ刂愤\(yùn)算符）等前后不加空格；☆ 【】 對(duì)于表達(dá)式比較長(zhǎng)的for語句和if語句，為了緊湊起見可以適當(dāng)?shù)厝サ粢恍┛崭瘢鏵or (i=0。 (c=d))amp。 i10。 I 10。y。 // Do not use array [ 5 ] = 0。 // Do not use b Function()。if (condition){… // program code}else{… // program code}if (condition){… // program code}else {