自從看了林銳博士的《高質量C++程式設計指南》以後，感覺自己以前寫的程式碼都是一些垃圾，真的low，根本不知道一些基本的程式設計規範，然後看了一些大神寫的程式碼，清晰易懂，而且還很漂亮，給人一種賞心悅目的感覺，寫一手高質量的程式碼，是一個程式設計師最基本的素養，程式碼的質量也能看出你是否有過專案經驗。因此，本文總結一些程式設計規範，為有需要的朋友提供幫助。有欠缺或者錯誤請大家幫忙斧正。

一、我們寫的程式碼是給別人看的，所以在程式碼開頭我們必須宣告這個程式是用來幹嘛的，作者是誰，以及版本號和修改歷史，以及修改者的名稱，還有完成的日期能讓別人一目瞭然。這是我的一個例子：

二、標頭檔案的使用：

1.首先說一下標頭檔案的作用：呼叫庫功能以及加強型別安全檢查。

2.為防止標頭檔案被重複引用，應該使用 ifndef/define/endif結構產生預處理塊。

3.#include <stdio.h> 格式引用標準庫的標頭檔案，即編譯器從標準庫目錄開始搜尋。#include "stdio.h"格式引用非標準庫的標頭檔案，即編譯器從使用者工作目錄開始搜尋。

4.在標頭檔案中最好不用全域性變數，不要出現extern int value這類宣告。

5.標頭檔案放在一份目錄下，定義檔案放在另一個目錄下，最好這樣分開。

三、具體程式：

1.空行

   程式好的佈局需要空行，每個函式定義結束之後加空行，在函式體內，邏輯密切相關語句不用空行，其他地方用空行分離。

void fun() 
{
    ...; 
} 
//空行 
void fun1() 
{ 
   while (1); 
  { 
    ...; 
    //空行 
    if (...) 
    { 
       ...; 
    } 
  } 
}
 //空行

2.程式碼行

   一行程式碼只做一件事情，定義變數或者是一條語句，在定義變數的同時最好將其初始化；

   if、for、while、do等語句佔一行，不論執行語句多長，都記得加‘{’、‘}’。

int a=1;
int b=2;
int c=a+b;
if (..)
{
   ....;
}
//空行
other();

3.程式碼行內的空格

   關鍵字之後留空格，if、for等關鍵字之後留空格再跟括號；

   向前緊跟的“，”、“（”、“）”、“；”不留空格；

   ”，“後留空格，”；“如果不是一行的結束符，其後留空格；

   操作符等二元操作符前後加空格，一元操作符前後不加空格；“[ ]”、“.”、“->”前後不加空格，

   對較長表示式可適當去掉一些空格。

void fun(int a ,int b, int c);

if (year >= 2000)

if ((a>=b) && (c<=d))

for (i=0 ; i<10; i++)

array[2] = 0;

int *x = &y;

void fun(int x)
{
    .....;
}

for (...)
{
    ....;
}

{

   {

      ...;

   }

}

5.長行拆分

  程式碼行最大長度控制在70至80個字元以內，便於檢視和列印，長表示式在低優先順序操作符處拆分成新行，操作符放在新行之首，並適當縮排

if ((a1 >= a2)
   && (a3 >= a4)
   && (a5 >= a6))

int main(a1,
             a2);

for (long;
      middle;
      short)

6.修飾符的位置

  * 和 & 緊靠變數名

7.註釋，註釋符有/*... */、//、#if 0,#endif

   註釋要少而精，不能喧賓奪主，它的作用是幫助理解程式碼；

   邊寫程式碼邊註釋，保證一致性，避免二義性以及在註釋中使用不常用縮寫；

   程式碼較長時，或者有多重巢狀時，應當在段落的結束處加註釋，便於閱讀。

好了，這篇文章就先了解標頭檔案與程式碼行的一些程式設計規範，下篇文章將講述命名規則與表示式的程式設計規範。