【正文】 Valid (ucStatItem))){ ... // program code}for (i=0, j=0。長(zhǎng)表達(dá)式換行循環(huán)、判斷等語(yǔ)句中若有較長(zhǎng)的表達(dá)式或語(yǔ)句，則要進(jìn)行適應(yīng)的劃分，長(zhǎng)表達(dá)式要在低優(yōu)先級(jí)操作符處劃分新行，操作符放在新行之首。}語(yǔ)句長(zhǎng)度要小于80個(gè)字符 一行語(yǔ)句以小于80字符為宜，不要寫(xiě)得過(guò)長(zhǎng)。 }}if ((ucCount == 1) amp。 (ucRetCode == 1)){ if (ucStatus == 39。 (ucRetCode == 0)){ *pucErrCode = EPRONTCENTER。) { *pucErrCode = 0。if ((ucCount == 1) amp?？梢圆捎每崭矜I來(lái)替代，4個(gè)空格代替一個(gè)【TAB】鍵。二、排版縮進(jìn)風(fēng)格 程序塊要采用縮進(jìn)風(fēng)格編寫(xiě)，縮進(jìn)的空格數(shù)為4個(gè)。常用單詞縮寫(xiě)見(jiàn)《附錄B 常用單詞及縮寫(xiě)》函數(shù)名應(yīng)準(zhǔn)確描述函數(shù)的功能避免使用無(wú)意義或含義不清的動(dòng)詞為函數(shù)命名 說(shuō)明：避免用含義不清的動(dòng)詞如process、handle等為函數(shù)命名，因?yàn)檫@些動(dòng)詞并沒(méi)有說(shuō)明要具體做什么。避免使用以下劃線開(kāi)始和結(jié)尾的定義 除了編譯開(kāi)關(guān)/頭文件等特殊應(yīng)用，應(yīng)避免使用_EXAMPLE_TEST_之類以下劃線開(kāi)始和結(jié)尾的定義程序中不要出現(xiàn)僅靠大小寫(xiě)區(qū)分的相似的標(biāo)識(shí)符 例如：　　uint　uix,　uiX。示例：uint uiMinSum。不要用數(shù)字或較奇怪的字符來(lái)定義標(biāo)識(shí)符 示例：如下命名，使人產(chǎn)生疑惑。 maxinformation”原則。六、命名注意事項(xiàng)：標(biāo)識(shí)符命名基本原則標(biāo)識(shí)符的命名要清晰、明了，有明確含義，同時(shí)使用完整的單詞或大家基本可以理解的縮寫(xiě)，避免使人產(chǎn)生誤解。例如：uchar *pucReceiveBuff[10]。二、變量命名規(guī)則局部變量命名：格式如下：序號(hào)說(shuō)明字體選擇備注1變量類型簡(jiǎn)寫(xiě)小寫(xiě)必選以最直觀模式給用戶區(qū)分不同的變量類型，最多2個(gè)字母長(zhǎng)度，具體參考《附錄A 常用變量類型及簡(jiǎn)寫(xiě)》2變量修飾首字母大寫(xiě)可選修飾詞英文名稱或者簡(jiǎn)寫(xiě)，最多2個(gè)單詞3變量名稱首字母大寫(xiě)必選名稱英文名稱或者簡(jiǎn)寫(xiě)，最多2個(gè)單詞例如：uchar ucCurrentValue。自定義頭文件引用：文件名包含著雙引號(hào)中。函數(shù)體： 可參考模塊《》文件結(jié)束說(shuō)明主要包含：文件結(jié)束說(shuō)明：End Of File可參考模塊《》二、h文件格式說(shuō)明文件創(chuàng)建及修改說(shuō)明區(qū)主要包含：公司信息：公司名稱、公司網(wǎng)站?？蓞⒖寄K《》全局變量定義區(qū)主要包含：全局變量定義區(qū)說(shuō)明注釋行：全局變量定義：要賦初值。修改信息：修改者名稱，修改日期，修改后版本號(hào)，修改內(nèi)容描述。簡(jiǎn)單功能的模塊采用一個(gè)c文件和h文件接口，復(fù)雜功能的模塊可能需要多個(gè)c文件和h文件。 公共變量?jī)H由模塊或函數(shù)創(chuàng)建和修改，其余模塊和函數(shù)只能訪問(wèn) 40局部變量 4嚴(yán)禁使用未經(jīng)初始化的變量作為右值 4不使用與硬件或軟件環(huán)境關(guān)系密切的變量 4變量聲明時(shí)，同一類型，不同意義的多個(gè)變量，要分行，便于區(qū)分 4對(duì)只設(shè)置一次的變量，宜使用“const”限定詞進(jìn)行聲明 4避免在函數(shù)中使用 static 局部變量 41數(shù)組 4數(shù)組大小及初始值要明確定義 4數(shù)組、結(jié)構(gòu)和聯(lián)合的初始化列表應(yīng)顯式描述 41結(jié)構(gòu)、聯(lián)合 4結(jié)構(gòu)的功能要單一，是針對(duì)一種事務(wù)的抽象 4不要設(shè)計(jì)面面俱到、非常靈活的數(shù)據(jù)結(jié)構(gòu) 4不同結(jié)構(gòu)間的關(guān)系不要過(guò)于復(fù)雜 4結(jié)構(gòu)中元素的個(gè)數(shù)應(yīng)適中 4結(jié)構(gòu)體中元素的布局 4結(jié)構(gòu)體設(shè)計(jì)要考慮兼容性 4跨平臺(tái)數(shù)據(jù)結(jié)構(gòu)，要考慮字節(jié)順序及對(duì)齊問(wèn)題 4struct或union類型中至少應(yīng)有一個(gè)成員 4struct或union類型的成員類型 46枚舉 4枚舉元素的初始化應(yīng)完整 47自定義數(shù)據(jù)類型 4合理地設(shè)計(jì)數(shù)據(jù)并使用自定義數(shù)據(jù)類型 4自定義數(shù)據(jù)類型命名要恰當(dāng) 47類型轉(zhuǎn)換 4謹(jǐn)慎使用數(shù)據(jù)類型的強(qiáng)制轉(zhuǎn)換 4了解編譯系統(tǒng)默認(rèn)的數(shù)據(jù)類型轉(zhuǎn)換 4應(yīng)禁止 signed 類型與 unsigned 類型之間的隱式轉(zhuǎn)化 4應(yīng)禁止 int 類型與 float 類型的隱式轉(zhuǎn)化 48指針 4不應(yīng)對(duì)指針變量使用強(qiáng)制類型轉(zhuǎn)換賦值 4不應(yīng)把自動(dòng)類型的局部變量的地址賦值給外部指針 4指針的指針不應(yīng)超過(guò)兩級(jí) 4指向不同數(shù)據(jù)類型的指針之間不應(yīng)相互轉(zhuǎn)換 4指針轉(zhuǎn)換過(guò)程中不應(yīng)丟失指針的const、 volatile屬性 4只有指向數(shù)組的指針才允許進(jìn)行算術(shù)運(yùn)算 4只有指向同一數(shù)組的兩個(gè)指針才允許相減 4只有指向同一數(shù)組的兩個(gè)指針才允許用、=、和=等關(guān)系運(yùn)算符進(jìn)行比較 4指針的索引值不應(yīng)為負(fù) 50、不應(yīng)對(duì)指針值可能為NULL的指針進(jìn)行算術(shù)運(yùn)算 50、調(diào)用返回類型為指針的函數(shù)后，應(yīng)進(jìn)行是否為空的判斷 50、局部變量的地址不應(yīng)在本對(duì)象消亡后傳給另外一個(gè)對(duì)象 50、一個(gè)未知大小的對(duì)象的指針不應(yīng)成為加法或者減法操作的左操作數(shù) 51六、函數(shù) 51函數(shù)編寫(xiě)原則 5明確函數(shù)功能，精確（而不是近似）地實(shí)現(xiàn)函數(shù)設(shè)計(jì) 5函數(shù)的規(guī)模盡量限制在200行以內(nèi) 5一個(gè)函數(shù)僅完成一件功能 5為簡(jiǎn)單功能編寫(xiě)函數(shù) 5不要設(shè)計(jì)多用途面面俱到的函數(shù) 5函數(shù)功能具有可預(yù)測(cè)性 5函數(shù)功能具有獨(dú)立性 5防止函數(shù)出現(xiàn)隨機(jī)內(nèi)聚 5功能不明確的較小函數(shù)，可以不必存在 5設(shè)計(jì)高扇入、合理扇出（小于7）的函數(shù) 5減少函數(shù)本身或函數(shù)間的遞歸調(diào)用 5降低函數(shù)間的耦合度 54函數(shù)參數(shù) 5明確接口函數(shù)參數(shù)的合法性檢查者 5防止將函數(shù)的參數(shù)作為工作變量 5避免設(shè)計(jì)多參數(shù)函數(shù)，不使用的參數(shù)從接口中去掉 5非調(diào)度函數(shù)應(yīng)減少或防止控制參數(shù)，盡量只使用數(shù)據(jù)參數(shù) 5檢查函數(shù)所有參數(shù)輸入的有效性 5檢查函數(shù)所有非參數(shù)輸入的有效性，如數(shù)據(jù)文件、公共變量等 5調(diào)用函數(shù)時(shí)參數(shù)類型要一致 5避免使用BOOL參數(shù) 5在函數(shù)參數(shù)中不應(yīng)使用static存儲(chǔ)類標(biāo)識(shí)符 5函數(shù)參數(shù)數(shù)量 5宜避免函數(shù)參數(shù)在調(diào)用中未被使用 57函數(shù)返回 5對(duì)所調(diào)用函數(shù)的錯(cuò)誤返回碼要仔細(xì)、全面地處理 5函數(shù)的返回值要清楚、明了，讓使用者不容易忽視錯(cuò)誤情況 5函數(shù)返回值要與賦值變量類型一致 5對(duì)于提供了返回值的函數(shù)，在引用時(shí)最好使用其返回值 5函數(shù)只有一個(gè)出口 58可重入函數(shù) 5可重入函數(shù)使用局部變量 5可重入函數(shù)使用全局變量 58函數(shù)模塊劃分 5仔細(xì)分析模塊的功能，進(jìn)行函數(shù)的劃分和組織 5如果多段代碼重復(fù)做同一件事情，那么在函數(shù)的劃分上可能存在問(wèn)題 5函數(shù)內(nèi)部的代碼結(jié)構(gòu)順序 59循環(huán)語(yǔ)句 60、循環(huán)控制變量的類型應(yīng)為整型 60、循環(huán)控制變量應(yīng)為局部變量 6for循環(huán)控制語(yǔ)句中的3 個(gè)表達(dá)式只應(yīng)和循環(huán)控制相關(guān) 6for循環(huán)不宜只執(zhí)行一次 61判斷語(yǔ)句 6不要輕易用條件分支去替換邏輯表達(dá)式 6switch語(yǔ)句中不應(yīng)只包含default語(yǔ)句 6所有非空的switch case子句都應(yīng)以break 語(yǔ)句結(jié)束 6switch控制表達(dá)式不應(yīng)是一個(gè)常量或邏輯表達(dá)式 6每一個(gè)switch語(yǔ)句都應(yīng)至少有一個(gè)case子句 6case表達(dá)式的類型應(yīng)與switch控制表達(dá)式的類型一致 6case表達(dá)式的大小不應(yīng)超過(guò)switch控制表達(dá)式的大小 61賦值語(yǔ)句 6盡量不使用條件賦值語(yǔ)句 62其他注意事項(xiàng) 6避免函數(shù)中不必要語(yǔ)句，防止程序中的垃圾代碼 6在多任務(wù)操作系統(tǒng)的環(huán)境下編程，更要注意函數(shù)可重入性的構(gòu)造 6將常用較長(zhǎng)變量用宏替代 62七、預(yù)處理 62宏 6用宏定義表達(dá)式時(shí)，要使用完備的括號(hào) 6將宏所定義的多條表達(dá)式放在大括號(hào)中 6使用宏時(shí)，不允許參數(shù)發(fā)生變化 6函數(shù)類宏調(diào)用時(shí)參數(shù)要完整 64條件編譯 6預(yù)處理語(yǔ)句“if”和“endif”不應(yīng)分散在不同的文件之中 6被包含文件中的“else”、“elseif”、“endif”不應(yīng)與父文件中的“if” 匹配 6“if”表達(dá)式中使用的宏應(yīng)該已經(jīng)被定義，并且“if”表達(dá)式只能包含整型常量 6宏如果需要被重定義，應(yīng)該先用“undef”解除前面的定義 64八、中斷 64中斷服務(wù)程序不應(yīng)有返回值 64中斷服務(wù)程序中不應(yīng)使用printf()函數(shù) 64對(duì)于中斷中使用到的非局部變量，在中斷處理函數(shù)中應(yīng)對(duì)其進(jìn)行入棧保護(hù) 64調(diào)用中斷處理程序中的變量要進(jìn)行開(kāi)關(guān)中斷處理 64對(duì)于開(kāi)關(guān)中斷，要注意成對(duì)匹配 64中斷服務(wù)程序代碼要簡(jiǎn)單化 65九、程序可測(cè)性 65原則 6統(tǒng)一的調(diào)測(cè)開(kāi)關(guān)及打印函數(shù) 6統(tǒng)一的打印信息串格式 6正式軟件產(chǎn)品中應(yīng)把斷言及其它調(diào)測(cè)代碼去掉（即把有關(guān)的調(diào)測(cè)開(kāi)關(guān)關(guān)掉） 6用調(diào)測(cè)開(kāi)關(guān)切換軟件的DEBUG版和正式版 6軟件DEBUG版和發(fā)行版在實(shí)現(xiàn)功能上具有一致性 6構(gòu)造測(cè)試環(huán)境和測(cè)試用例 6預(yù)先設(shè)計(jì)程序調(diào)測(cè)的方法和手段及各種調(diào)測(cè)開(kāi)關(guān) 6調(diào)測(cè)開(kāi)關(guān)應(yīng)分為不同級(jí)別和類型 66斷言 6使用斷言來(lái)發(fā)現(xiàn)軟件問(wèn)題，提高代碼可測(cè)性 6用斷言來(lái)檢查程序正常運(yùn)行時(shí)不應(yīng)發(fā)生但在調(diào)測(cè)時(shí)有可能發(fā)生的非法情況 6不能用斷言來(lái)檢查最終產(chǎn)品肯定會(huì)出現(xiàn)且必須處理的錯(cuò)誤情況 6對(duì)較復(fù)雜的斷言加上明確的注釋 6用斷言確認(rèn)函數(shù)的參數(shù) 6用斷言保證沒(méi)有定義的特性或功能不被使用 6用斷言對(duì)程序開(kāi)發(fā)環(huán)境（OS/Compiler/Hardware）的假設(shè)進(jìn)行檢查 6編寫(xiě)防錯(cuò)程序，然后在處理錯(cuò)誤之后可用斷言宣布發(fā)生錯(cuò)誤 68十、程序效率 69原則 6編程時(shí)要經(jīng)常注意代碼的效率 6提高代碼效率的前提 6局部效率應(yīng)為全局效率服務(wù) 6合理劃分模塊函數(shù) 6不應(yīng)花過(guò)多的時(shí)間拼命地提高調(diào)用不很頻繁的函數(shù)代碼效率 70、不要一味追求緊湊的代碼 70、不應(yīng)存在執(zhí)行不到的代碼 70、去掉沒(méi)必要的全局變量 70方法 70、解決軟件空間效率1 70、解決軟件空間效率2 7循環(huán)體內(nèi)工作量最小化 7仔細(xì)分析有關(guān)算法，并進(jìn)行優(yōu)化 7仔細(xì)考查、分析系統(tǒng)及模塊處理輸入（如事務(wù)、消息等）的方式，并加以改進(jìn) 7直接用匯編編寫(xiě)調(diào)用頻繁或性能要求極高的函數(shù) 7在多重循環(huán)中，應(yīng)將最忙的循環(huán)放在最內(nèi)層 7盡量減少循環(huán)嵌套層次 7盡量不在循環(huán)體內(nèi)放置判斷語(yǔ)句 7盡量用乘法或其它方法代替除法，特別是浮點(diǎn)運(yùn)算中的除法 7應(yīng)注意switchcase語(yǔ)句的使用 74十一、程序質(zhì)量 74原則 7代碼質(zhì)量保證優(yōu)先原則 7合理劃分子模塊，提高可移植性和可重用性 7提供良好的接口界面 7系統(tǒng)具有一定容錯(cuò)能力 75方法 7認(rèn)真處理程序所能遇到的各種出錯(cuò)情況 7系統(tǒng)運(yùn)行之初，要初始化有關(guān)變量及運(yùn)行環(huán)境，防止未經(jīng)初始化的變量被引用 7系統(tǒng)運(yùn)行之初，要對(duì)加載到系統(tǒng)中的數(shù)據(jù)進(jìn)行一致性檢查 7嚴(yán)禁隨意更改其它模塊或系統(tǒng)的有關(guān)設(shè)置和配置 7不能隨意改變與其它模塊的接口 7防止內(nèi)存操作越界 7編程時(shí)，要防止差1錯(cuò)誤 7要時(shí)刻注意易混淆的操作符 7條件判斷語(yǔ)句必須處理所有情況 7不要用goto語(yǔ)句 7盡量都采用標(biāo)準(zhǔn)語(yǔ)句和標(biāo)準(zhǔn)庫(kù)函數(shù) 7避免使用嵌入式匯編 7精心構(gòu)造算法，并對(duì)其性能、效率進(jìn)行測(cè)試 7對(duì)較關(guān)鍵的算法最好使用其它算法來(lái)確認(rèn) 7時(shí)刻注意表達(dá)式是否會(huì)上溢、下溢 7使用變量時(shí)要注意其邊界值的情況 7注意程序代碼是否超過(guò)系統(tǒng)有關(guān)限制 7循環(huán)、分支層次不要超過(guò)五層 7不要比較浮點(diǎn)數(shù)的相等 7關(guān)注共用體的存儲(chǔ)、對(duì)齊模式 7頭文件中不應(yīng)有對(duì)象或函數(shù)的定義 7不應(yīng)單獨(dú)使用小寫(xiě)字母“l(fā)”或大寫(xiě)字母“O”作為變量名 7函數(shù)聲明時(shí)參數(shù)不應(yīng)只有類型名沒(méi)有標(biāo)識(shí)符 7不應(yīng)對(duì)有符號(hào)數(shù)進(jìn)行位運(yùn)算 7無(wú)格式的字符型不應(yīng)與負(fù)數(shù)常量和零比較 7無(wú)符號(hào)值不應(yīng)與負(fù)數(shù)常量比較 7對(duì)變量進(jìn)行移位操作應(yīng)保證不會(huì)產(chǎn)生溢出和數(shù)據(jù)截短 7不應(yīng)在布爾表達(dá)式中使用賦值操作符 7不應(yīng)對(duì)布爾表達(dá)式進(jìn)行算術(shù)或者位運(yùn)算 7表達(dá)式的值在任何求值順序下應(yīng)保持一致 7應(yīng)避免除數(shù)可能為0的情況出現(xiàn) 7賦值運(yùn)算符的左操作數(shù)不應(yīng)進(jìn)行轉(zhuǎn)換操作，并且應(yīng)該是一個(gè)可更改的對(duì)象 7sizeof操作符不應(yīng)用在有單邊作用的表達(dá)式上 7留心具體語(yǔ)言及編譯器處理不同數(shù)據(jù)類型的原則及有關(guān)細(xì)節(jié) 80十二、代碼代碼編輯、編譯、審查 80打開(kāi)編譯器的所有告警開(kāi)關(guān)對(duì)程序進(jìn)行編譯 80在產(chǎn)品軟件（項(xiàng)目組）中，要統(tǒng)一編譯開(kāi)關(guān)選項(xiàng) 80通過(guò)代碼走讀及審查方式對(duì)代碼進(jìn)行檢查 80測(cè)試部測(cè)試產(chǎn)品之前，應(yīng)對(duì)代碼進(jìn)行抽查及評(píng)審 80養(yǎng)成隨時(shí)保存編寫(xiě)代碼的習(xí)慣 80同產(chǎn)品軟件（項(xiàng)目組）內(nèi)，最好使用相同的編輯器，并使用相同的設(shè)置選項(xiàng) 80