【正文】 ++程序設(shè)計討論。 制定本編程規(guī)范的目的是為了提高軟件開發(fā)效率及所開發(fā)軟件的可維護性，提高軟件的質(zhì)量。修改日期修改內(nèi)容是否備份備注三、開發(fā)代碼規(guī)范 在研究項目團隊協(xié)作開發(fā)的情況下（這里的團隊協(xié)作也適合于應(yīng)用項目的開發(fā)），編程時應(yīng)該強調(diào)的一個重要方面是程序的易讀性，在保證軟件速度等性能指標能滿足用戶需求的情況下，能讓其他程序員容易讀懂你所編寫的程序。圖4 系統(tǒng)功能業(yè)務(wù)流程圖舉例 開發(fā)修改記錄1. 開發(fā)代碼做好備份（可以在完成一個重大功能之后，或者按時間周期性進行備份），以免由于不可抗力導致代碼不可修復。圖1 系統(tǒng)邏輯架構(gòu)圖舉例圖2 物理架構(gòu)圖舉例 系統(tǒng)功能模塊設(shè)計給出系統(tǒng)的主要功能模塊，每個模塊所包含的功能。 系統(tǒng)架構(gòu)（系統(tǒng)組成）確定系統(tǒng)整體體系架構(gòu)，各層次之間的數(shù)據(jù)流的連接，確定軟件服務(wù)器的硬件配置及用戶硬件資源配置， 確定與用戶軟件平臺的統(tǒng)一協(xié)調(diào)。開發(fā)人員要明確系統(tǒng)開發(fā)擬采用的數(shù)據(jù)庫、操作系統(tǒng)、開發(fā)語言、開發(fā)工具、服務(wù)器等（具體到版本）。二、開發(fā)流程規(guī)范 接受開發(fā)任務(wù)，詳細閱讀軟件技術(shù)規(guī)范或技術(shù)文檔，如對技術(shù)文檔有疑義或者不清楚的地方及時與項目總工或用戶溝通，根據(jù)文檔和溝通內(nèi)容編寫項目開發(fā)計劃，必須包括但不限于系統(tǒng)軟硬件開發(fā)環(huán)境、系統(tǒng)架構(gòu)、系統(tǒng)功能模塊設(shè)計、系統(tǒng)功能開發(fā)流程圖、開發(fā)修改記錄。本規(guī)范包含：開發(fā)流程規(guī)范和開發(fā)代碼規(guī)范等，開發(fā)流程規(guī)范需要技術(shù)開發(fā)人員編寫相關(guān)內(nèi)容，希望每個技術(shù)人員形成習慣，如有新的內(nèi)容更新會及時通知大家，如有好的規(guī)范要求也可通知編制人員及時更新。軟件開發(fā)流程規(guī)范德聯(lián)軟件有限責任公司編制人： 侯秀美 審核人： 2015 年 8 月 19 日目錄目錄 0一、概述 2二、開發(fā)流程規(guī)范 3 系統(tǒng)軟硬件開發(fā)環(huán)境 3 系統(tǒng)架構(gòu)（系統(tǒng)組成） 5 系統(tǒng)功能模塊設(shè)計 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 程序風格 16 空行 17 代碼行 18 代碼行內(nèi)的空格 19 對齊 20 長行拆分 22 修飾符的位置 23 注釋 23 函數(shù)設(shè)計 26 參數(shù)的規(guī)則 26 返回值的規(guī)則 27 函數(shù)內(nèi)部實現(xiàn)的規(guī)則 30 其它建議 32 使用斷言 32 引用與指針的比較 33 變量類型定義 35四、軟件測試規(guī)范 36 單元測試 36 系統(tǒng)測試 37 業(yè)務(wù)測試 38 驗收測試 38 用戶現(xiàn)場測試 38五、軟件版本管理 39 39一、概述本文制定煙臺開發(fā)區(qū)德聯(lián)軟件有限責任公司計算機軟件開發(fā)規(guī)范文檔。本規(guī)范的目的是使公司軟件開發(fā)項目階段清晰、要求明確、任務(wù)具體、編寫的代碼規(guī)范，使之規(guī)范化、系統(tǒng)化和工程化，向公司內(nèi)從事軟件開發(fā)的工程師和管理人員提出一系列規(guī)范和要求，從而有利于開發(fā)過程的控制和管理，提高所開發(fā)軟件系統(tǒng)的質(zhì)量，縮短開發(fā)時間，減少開發(fā)和維護費用，以保證項目高質(zhì)量、順利進行。本規(guī)范為煙臺開發(fā)區(qū)德聯(lián)軟件有限責任公司內(nèi)部材料，嚴禁其他商業(yè)應(yīng)用。 系統(tǒng)軟硬件開發(fā)環(huán)境開發(fā)環(huán)境的搭建，最好形成文檔，便于以后同樣工作的使用。明確整個系統(tǒng)開發(fā)工作流程，至少應(yīng)該包括以下流程。 開發(fā)人員在繪制架構(gòu)圖時給出基本框架，能反映出基本意義即可，可以直接用文字代替例子中的圖片。圖3 圖書管理系統(tǒng)模塊規(guī)劃圖舉例 系統(tǒng)功能開發(fā)流程圖給出系統(tǒng)主要功能的業(yè)務(wù)流程圖。（改動的具體細節(jié)），修改前的版本要及時備份，可以方面隨時還原系統(tǒng)。若研究項目小組的所有開發(fā)人員都遵循統(tǒng)一的、鮮明的一套編程風格，可以讓協(xié)作者、后繼者和自己一目了然，在很短的時間內(nèi)看清楚程序結(jié)構(gòu)，理解設(shè)計的思路，大大提高代碼的可讀性、可重用性、程序健壯性、可移植性、可維護性。本規(guī)范由程序風格、命名規(guī)范、注釋規(guī)范、程序健壯性、可移植性、錯誤處理以及軟件的模塊化規(guī)范等部分組成。 文件結(jié)構(gòu) 每個C++/C程序通常分為兩個文件。另一個文件用于保存程序的實現(xiàn)（implementation），稱為定義（definition）文件。 文件信息聲明文件信息聲明位于頭文件和定義文件的開頭（參見示例31），主要內(nèi)容有：（1） 版權(quán)信息；（2） 文件名稱，項目代碼，摘要，參考文獻；（3） 當前版本號，作者/修改者，完成日期；（4） 版本歷史信息；（5） 主要函數(shù)描述。////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// 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 文件信息聲明☆ 【】 文件信息聲明以兩行斜杠開始，以兩行斜杠結(jié)束，每一行都以兩個斜杠開始；☆ 【】 文件信息聲明包含五個部分，各部分之間以一空行間隔；☆ 頭文件的結(jié)構(gòu)頭文件由三部分內(nèi)容組成： (1) 預(yù)處理塊；(3)假設(shè)頭文件名稱為 ，頭文件的結(jié)構(gòu)參見示例32。這雖然會帶來書寫上的方便，但卻造成了風格不一致，弊大于利。頭文件的結(jié)構(gòu)如下：//文件信息聲明見示例31，此處省略。ifndef _FILE_SYSTEM_H_ //avoid referencing the file repeatdefine _FILE_SYSTEM_H_include //reference standard head file…include “” //reference nonstandard head file…void Function1(…)。endif示例32 C++/C頭文件的結(jié)構(gòu) 定義文件開頭處的文件信息聲明(參見示例31)；(2) 程序的實現(xiàn)體（包括數(shù)據(jù)和代碼）。//文件信息聲明見示例31，此處省略。include “” //reference a head file…//global function realizationvoid Function1(…){…}這里對頭文件的作用略作解釋： （1） 通過頭文件來調(diào)用庫功能。用戶只需要按照頭文件中的接口聲明來調(diào)用庫功能，而不必關(guān)心接口怎么實現(xiàn)的。如果某個接口被實現(xiàn)或被使用時，其方式與頭文件中的聲明不一致，編譯器就會指出錯誤，這一簡單的規(guī)則能大大減輕程序員調(diào)試、改錯的負擔。 例如可將頭文件保存于include目錄，將定義文件保存于source目錄（可以是多級目錄）。為了加強信息隱藏，這些私有的頭文件可以和定義文件存放于同一個目錄。例如所有的字符變量均以ch為前綴，若是指針變量則追加前綴p。 “匈牙利”法最大的缺點是煩瑣，例如 int i, j, k。 倘若采用“匈牙利”命名規(guī)則，則應(yīng)當寫成 int iI, iJ, ik。 // 前綴 f表示float類型 如此煩瑣的程序會讓絕大多數(shù)程序員無法忍受。 共性原則本節(jié)論述的共性規(guī)則是被大多數(shù)程序員采納的，我們應(yīng)當在遵循這些共性規(guī)則的前提下，再擴充特定的規(guī)則，☆ 【】 標識符應(yīng)當直觀且可以拼讀，可望文知意，不必進行“解碼”；☆ 【】 標識符的長度應(yīng)當符合“minlength amp。 maxinformation”原則；☆ 【】 命名規(guī)則盡量與所采用的操作系統(tǒng)或開發(fā)工具的風格保持一致；☆ 【】 程序中不要出現(xiàn)僅靠大小寫區(qū)分的相似的標識符。 標識符最好采用英文單詞或其組合，便于記憶和閱讀，切忌使用漢語拼音來命名，程序中的英文單詞一般不要太復雜，用詞應(yīng)當準確，例如不要把CurrentValue寫成NowValue； 不同的操作系統(tǒng)的程序設(shè)計風格是不一樣的，例如Windows應(yīng)用程序的標識符通常采用“大小寫”混排的方式，如AddChild，而Unix應(yīng)用程序的標識符通常采用“小寫加下劃線”的方式，如add_child，別把這兩類風格混在一起使用； Windows變量命名規(guī)則☆ 【】 變量的命名規(guī)則要求采用“匈牙利法則”，即開頭字母用變量的類型，其余部分用變量的英文意思或其英文意思的縮寫，盡量避免采用中文拼音，要求單詞的第一個字母大寫；即：變量名＝變量類型＋變量英文意思(或縮寫)變量類型請參見附表1－變量類型表；☆ 【】 類名和函數(shù)名用大