【正文】 er a max = array[index]。以下是使用空格符的一些指導(dǎo)規(guī)范:254。 // Implementation starts here // if（...） { }}在本例中，過多的空行造成了空行濫用，并不能使代碼更易于閱讀。 Good: // C++ sample:void ProcessItem（const Itemamp。 ） == ） { ...}Good: [Flags]public enum BorderStyle { Fixed3D = 0x1, FixedSingle = 0x2, None = 0x0}if （ == ）{ ...} 空行254。 如下C 示例展示了 一常見的檢查某一標志是否被設(shè)置了的實現(xiàn)（查看如下 if語句）。 便是標志枚舉特殊值的一個示例 。 一定請 利用2進制強大的能力，因為它可以自由的進行位異或運算。254。 Good: // C sample:if （c || c ）{ throw new ArgumentOutOfRangeException（...）。// C sample:public enum Compression{ None = 0, GZip, Deflate}253。 一定不要 使用公開集合作為枚舉 （例如操作系統(tǒng)版本，您親朋的姓名）。Good: // C sample:public enum Color{ Red, Green, Blue}Bad: // C sample:public static class Color{ public const int Red = 0。254。Bad:// C sample:a = 1。 一定不要 在同一行內(nèi)放置一句以上的代碼語句。比如，如果一個函數(shù)帶有2個參數(shù)， “l(fā)eft” 和 “right” ，將 “l(fā)eft” 置于 “right” 之前，則它們的放置順序符合其參數(shù)名。 // C++ / C sample:hr = DoSomeFunctionCall（ hwnd, param1, param2, param3, param4, param5）。多行格式:// C function call sample:hr = DoSomeFunctionCall（param1, param2, param3, param4, param5）。原則上應(yīng)該都將這些置于同一行代碼內(nèi)。后一個代碼示例經(jīng)常被誤寫為:CodeExample *pFirst, pSecond。推薦每行只包含一句聲明，這樣有利于添加注釋，也減少歧義。// C sample:string name = 。 一定請 在聲明變量時初始化它們。 變量的聲明和初始化 254。 為了正確的使用全局變量，一般是將它們作為參數(shù)傳入函數(shù)。 一定不要 引用不必要的庫，包括不必要的頭文件，或引用不必要的程序集。若78列太窄，可以設(shè)置為86或者90。254。 一定不要使用制表符。沒有什么勝于清晰、簡潔、自描述的代碼。2 通用編程規(guī)范這些通用編程規(guī)范適用于所有語言 – 它們對代碼風(fēng)格，格式和結(jié)構(gòu)提供了全局通用的指導(dǎo)。 您不應(yīng)該..不應(yīng)該應(yīng)用該規(guī)范或?qū)嵺`，除非有合理的理由。254。如果您認為您的應(yīng)用是例外，則可能不適用。一些實踐是非常重要的，必須嚴格執(zhí)行，另一些指導(dǎo)準則并不一定處處適用，但是會在特定的場景下帶來益處。6. 安全性 示例代碼應(yīng)該展示如何使用安全的編程實踐 ：例如最低權(quán)限原則，使用運行時庫函數(shù)的安全版本，以及SDL推薦的項目設(shè)置。示例代碼應(yīng)當使用當前推薦的運行時庫和API函數(shù)，以及推薦的項目和生成設(shè)置。3. 一致性 – 示例代碼應(yīng)該按照一致的編程風(fēng)格和設(shè)計來保證代碼易讀。示例代碼不可包含多余代碼。萬事開頭難，采納一個不熟悉的規(guī)范可能在初期會有一些棘手和困擾，但是這些不適應(yīng)很快便會消失，它所帶來的好處和優(yōu)勢很快便會顯現(xiàn)，特別是在當您接手他人代碼時。該規(guī)范源自于產(chǎn)品開發(fā)過程中的經(jīng)驗，并在不斷完善。J聲明本編程規(guī)范文檔以“如是”提供，無論明示或暗示都不包含任何形式保證，但并不限制適用于特殊目的的默認擔(dān)保。感謝他們的慷慨共享。我很榮幸能與他共事。Microsoft C編碼規(guī)范本文檔描述了微軟一站式代碼示例庫項目組所采納的關(guān)于本地 C++ 和 .NET （C ）代碼的編程風(fēng)格指導(dǎo)規(guī)范。 我同樣感謝微軟的四位經(jīng)理，感謝他們對該項目的一貫支持。本編程規(guī)范在不斷改善。 當您編寫VC++/VC/ 代碼時，敬請參考或使用本文檔。如果您發(fā)現(xiàn)一些最佳實踐或者話題并沒有涵蓋在本文檔中，請聯(lián)系我們一站式示例代碼庫項目組 ，以不斷充實完善本文檔。 原則和主旨高質(zhì)量的代碼示例往往具有如下特質(zhì):1. 易懂 – 代碼示例必須易讀且簡單明確。它們必須帶有相應(yīng)文檔說明。 同樣的，不同代碼示例之間也應(yīng)當保持一致的風(fēng)格和設(shè)計，使使用者能夠很輕松的結(jié)合使用它們。5. 可靠性 – 代碼示例必須符合法律，隱私和政策標準和規(guī)范。 合理使用編程實踐，設(shè)計和語言特性決定了示例代碼是否可以很好滿足上述特性。為了清楚陳述規(guī)范和實踐的意圖，我們會使用如下術(shù)語。該規(guī)范用于減少bug。 您應(yīng)該...該規(guī)范和實踐適用于大多數(shù)情況。254。 明確性和一致性254。254。不同的文字編輯器使用不同的空格來生成制表符 ，這就帶來了格式混亂。 您應(yīng)該 限制一行代碼的最大長度。Visual C 示例:254。注重細節(jié)能夠減少項目生成時間，最小化出錯幾率， 并給讀者一個良好的印象。永遠不要在函數(shù)或類內(nèi)部直接引用全局變量，因為這會引起一個副作用：在調(diào)用者不知情的情況下改變了全局變量的狀態(tài)。 一定請在最小的，包含該局部變量的作用域塊內(nèi)聲明它。254。int val = 。例如 Visual C++ 示例，Good:CodeExample *pFirst = NULL。這種誤寫實際上等同于:CodeExample *pFirst。如果帶有過多參數(shù)不能置于一行代碼，可以進行換行：多個參數(shù)一行或者一個參數(shù)一行。將參數(shù)列表置于多行代碼時，每一個參數(shù)應(yīng)該整齊排列于前一個參數(shù)的下方。254。當設(shè)計一系列具有相同參數(shù)的函數(shù)時，在各函數(shù)內(nèi)使用一致的順序。 這會使得調(diào)試器的單步調(diào)試變得更為困難。 b = 2。 一定請在合適的情況下盡量使用枚舉類型，而不是靜態(tài)常量或 “define” 值 。 public const int Green = 1。254。 一定不要 來檢查枚舉范圍。}Bad: // C sample:if （!（typeof（Color）, c））{ throw new InvalidEnumArgumentException（...）。 一定要 將 應(yīng)用于標志枚舉。舉例，// C sample:[Flags]public enum AttributeTargets { Assembly = 0x0001, Class = 0x0002, Struct = 0x0004, ...}254。然而，如果一個標志枚舉中的某些值組合起來是非法的，您就不應(yīng)該創(chuàng)建這樣的標志枚舉。 該檢查運行結(jié)果正確，但是有一處例外，便是對于0值的檢查，它的布爾表達式結(jié)果恒為true。 您應(yīng)該使用空行來分隔相關(guān)語句塊 。 item）{ int counter = 0。254。 您應(yīng)該 像如下般在一行代碼中使用空格 。 // No spaces inside bracketswhile （x == y） // Single space before flow control statementsif （x == y） // Single space separates operatorsBad:// C++ / C sample:CreateFoo （）。 // Spaces inside bracketswhile（x == y） // No space before flow control statementsif （x==y） // No space separates operators 大括號254。大括號內(nèi)的語句縮進一個等級。 您應(yīng)該 在即使是單行條件式的情況下也使用大括號。 注釋254。 您應(yīng)該使用 ‘//’ 注釋方式，而不是 ‘/* */’ 來為 C++ 和 C 代碼作注釋。 254。 Intialize the ponents on the Windows Form.InitializeComponent（）Bad://intialize the ponents on the Windows Form.InitializeComponent（）。其之后不需要空行。 // The value is out of range, we cannot continue. return E_INVALIDARG。 // Continue if not finished. }private: int m_length。 您不應(yīng)該 在代碼中留有過多注釋。 i = nLastWrinkle。 // Process if it’s a new wrinkle nMaxImpact pWrinkleGetImpact（）） // And it has the biggest impact { nMaxImpact = pWrinkleGetImpact（）。 i++）{ Wrinkle *pWrinkle = apWrinkles[i]。 pBestWrinkle = pWrinkle。 一定請 為每一份手寫代碼文件加入文件頭注釋。 C 和 使用 .NET 描述性 XML 文檔化 注釋。 您應(yīng)該 為所有重要的Public或非Public函數(shù)作注釋 。會拋出異常的方法應(yīng)使用exception 元素來告知使用者哪些異常會被拋出。 else wprintf （LUser is not a member of the Administrators group\n）。當出現(xiàn)副作用時，在編寫代碼時應(yīng)該有清楚的理由。 使用 [or] 來分隔多個方法。 一定不要 在已發(fā)布的代碼示例中使用TODO 待辦注釋。通過作用域或者功能性分類，將大量代碼分組，會改善代碼易讀性和結(jié)構(gòu)。因此，建議你同時參照這兩份文檔 。 254。StandardExample將 copyright設(shè)置為Copyright 169。其命名應(yīng)能反映其作用。對于公共類型，線程過程，窗口過程，和對話框過程函數(shù)，為“ThreadProc”, “DialogProc”, “WndProc” 等使用公共后綴。標識符規(guī)范命名結(jié)構(gòu) 示例類，結(jié)構(gòu)體Pascal規(guī)范名詞public class ComplexNumber {...}public struct ComplextStruct {...}命名空間Pascal規(guī)范名詞253。[Flags]public enum ConsoleModifiers { Alt, Control }方法Pascal規(guī)范動詞或動詞短語public void Print（） {...}public void ProcessItem（） {...}Public屬性Pascal規(guī)范名詞或形容詞254。當以 “Is,” “Can,” or “Has” 作布爾屬性的前綴有意義時，您也可以這樣做。 前綴時，保持代碼一致性。 一定請 用現(xiàn)在式或過去式來表明事件之前或是之后的概念。 一定請 為用于事件的委托增加‘EventHandler’ 后綴。 一定不要 為委托增加 “Delegate” 后綴。private const string messageText = B。 一定請 以描述性名稱命名泛型參數(shù)，除非單字符名稱已有足夠描述性。 您應(yīng)該 使用 T 作為單字符類型參數(shù)的名稱。254。 戶界面 控件命名規(guī)范用戶控件應(yīng)該使用如下前綴，其重要目的是使代碼更易讀。編譯器直接將常量字段嵌入調(diào)用代碼處。}254。 public static readonly ShellFolder ProgramFiles = new ShellFolder（ProgramData）。相反，您應(yīng)該使用StringBuilder 來實現(xiàn)拼接工作。for (int i = 0。 一定請 使用 顯式地指定了字符串比較規(guī)則的重載函數(shù)。254。一般而言。 比如，忽略大小寫后，判斷2個字符串是否相等，if （（str2, ））If （（str2, ）） Then253。 一定請 在字符串比較時， 。 集合提供了