Linux有獨(dú)特的編程風(fēng)格,在內(nèi)核源代碼目錄Documentation/CodingStyle,詳細(xì)描述代碼風(fēng)格。

建議大家可以去看一下，老外寫技術(shù)文檔還是很有意思的，上來(lái)就狂噴，“你不這樣寫就會(huì)完蛋，異教徒才不這樣寫……”，沒(méi)有國(guó)內(nèi)那么刻板，多閱讀英語(yǔ)文檔對(duì)技術(shù)增長(zhǎng)很有幫助。

1. 命名規(guī)范

在一般編程中,習(xí)慣以如下方式命名宏、變量和函數(shù):

#define PI 3.1415926 /*用大寫字母代表宏 */
int minValue, maxValue; /*變量:第一個(gè)單詞全小寫,其后單詞的第一個(gè)字母大寫*/
void SendData (void); /* 函數(shù):所有單詞第一個(gè)字母都大寫 */

這種通過(guò)單詞之間通過(guò)首字母大寫來(lái)區(qū)分的方式非常流行。通過(guò)第1個(gè)單詞的首字母是否大寫可以區(qū)分名稱屬于變量還是屬于函數(shù),而看到整串的大寫字母可以斷定為宏。

許多領(lǐng)域的程序開發(fā)都遵照此習(xí)慣。

但是Linux不以這種習(xí)慣命名,對(duì)于上面的一段程序,在Linux中它會(huì)被命名為:

#define PI 3.1415926
int min_value, max_value;
void send_data (void);

在上述命名方式中,宏還是一樣用大寫，但變量和函數(shù)名，不按照Windows所采用的用首字母大寫來(lái)區(qū)分單詞，而是采用下劃線。而且Linux下命名，全局變量命名最好用長(zhǎng)的準(zhǔn)確的描述，局部變量最好簡(jiǎn)短，甚至直接用tmp，i之類的。

其實(shí)兩種命名方式都行，寫Liunx下的程序時(shí)，與Linux社區(qū)代碼風(fēng)格一致更好，但你用第一種我覺(jué)得也無(wú)傷大雅。

2.縮進(jìn)

縮進(jìn)統(tǒng)一使用"TAB",而不是空格括號(hào)。

另外提一句：在Linux下，"TAB"代表8個(gè)字符，而不是4個(gè)，Linux代碼風(fēng)格認(rèn)為8個(gè)字符更能體現(xiàn)層次結(jié)構(gòu)。文檔里噴"TAB"為4字符的是異教徒，對(duì)于8字符在多層次時(shí)，代碼太偏右的問(wèn)題，文檔又噴層次超過(guò)三層，你的代碼就會(huì)完蛋，哈哈哈。

為了減少層次，在switch/case語(yǔ)句方面, Linux 建議switch和case對(duì)齊,例如:

switch (suffix) {
case 'G':
case 'g':
    mem < <= 30;
    break;
case 'M':
case 'm':
    mem < <= 20;
    break;
case 'K':
case 'k':
    mem < <= 10;
    /* fall through */
default:
    break;
}

3. Linux中代碼括號(hào)“{”和“}”的使用原則

1)對(duì)于結(jié)構(gòu)體、if/for/while/switch語(yǔ)句, “{”不另起一行,例如:

struct var_data {
    int len;
    char data[0];
};

if (a == b) {
    a = c;
    d = a;
}

for (i = 0; i < 10; i++) {
    a = c;
    d = a;
}

2)如果if、for循環(huán)后只有1行,不要加“{”和“}”,例如:

for (i = 0; i < 10; i++) {
     a = c;
}

應(yīng)該改為:

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

3. if和else混用的情況下, else語(yǔ)句不另起一行,例如:

if (x == y){
    ...
} else if (x > y) {
    ...
} else {
    ...
}

4)對(duì)于函數(shù), “{”另起一行,例如:

int add (int a, int b)
[
    return a + b;
}

4. 空格的使用

1）關(guān)鍵字后加空格

在這些關(guān)鍵字后面加空格：

if, switch, case, for, do, while

但是這些不加：

sizeof, typeof, alignof, attribute

例如：

s = sizeof(struct file);

2）括號(hào)內(nèi)，緊挨著括號(hào)不加空格

錯(cuò)誤示范：

s = sizeof( struct file );

3）對(duì)于指針，”*“號(hào)挨著名字而不是類型

例如：

char *linux_banner;
unsigned long long memparse(char *ptr, char **retptr);
char *match_strdup(substring_t *s);

4）操作符兩側(cè)加空格

以下二元或三元操作符兩側(cè)要加空格：

= + - < > * / % | & ^ <= >= == != ? :

但是以下一元操作符，不加空格：

& * + - ~ ! sizeof typeof alignof attribute defined

自增自減符號(hào)。不加空格：

++ --

結(jié)構(gòu)體成員操作符，不加空格：

'.' 和 "->"

不要在行尾加空格。

5. 函數(shù)

函數(shù)應(yīng)該簡(jiǎn)潔明了，只做一件事。函數(shù)長(zhǎng)度應(yīng)該控制在一到兩個(gè)屏幕顯示范圍內(nèi)(ISO/ANSI屏幕大小是80x24)。

如果你有一個(gè)概念上簡(jiǎn)單的函數(shù)，那么使用一個(gè)更長(zhǎng)的函數(shù)是可以的，比如函數(shù)里是case。

在源文件中，用空行分隔函數(shù)。如果函數(shù)被導(dǎo)出，它的EXPORT*宏應(yīng)該緊跟在結(jié)束的函數(shù)大括號(hào)行之后。例如:

int system_is_up(void)
{
  return system_state == SYSTEM_RUNNING;
}
EXPORT_SYMBOL(system_is_up);

6. goto語(yǔ)句的使用

用不用goto一直是一個(gè)著名的爭(zhēng)議話題, Linux內(nèi)核源代碼中對(duì)goto的應(yīng)用非常廣泛,但是一般只限于錯(cuò)誤處理中,其結(jié)構(gòu)如:

if(register_a() != 0)
    goto err;
if (register_b() != 0)
    goto errl;
if(register_c() != 0)
    goto err2;
if (register_d () != 0)
    goto err3;
err3: 
    unregister_c();
err2: 
    unregister_b ();
errl: 
    unregister_a ();
err: 
    return ret;

這種將goto用于錯(cuò)誤處理的用法實(shí)在是簡(jiǎn)單而高效,只需保證在錯(cuò)誤處理時(shí)注銷、資源釋放等,與正常的注冊(cè)、資源申請(qǐng)順序相反。

7. 注釋

Linux風(fēng)格的注釋是c89 "/… /”風(fēng)格。不要使用c99風(fēng)格的“//…”注釋。

長(zhǎng)(多行)注釋的首選樣式是:

/*
   * This is the preferred style for multi-line
   * comments in the Linux kernel source code.
   * Please use it consistently.
   *
   * Description:  A column of asterisks on the left side,
   * with beginning and ending almost-blank lines.
   */

8.do {} while(0) 語(yǔ)句

在Linux內(nèi)核中,經(jīng)常會(huì)看到do {} while(0)這樣的語(yǔ)句。

許多人開始都會(huì)疑惑,認(rèn)為do while(0)毫無(wú)意義,因?yàn)樗粫?huì)執(zhí)行一次,加不加do {} while(0)效果是完全一樣的,其實(shí)do {} while(0)的用法主要用于宏定義中。

這里用一個(gè)簡(jiǎn)單的宏來(lái)演示:

#define SAFE_FREE (p) do{ free (p); p = NULL;}  while (0)

假設(shè)這里去掉do...while(0),即定義SAFE_DELETE為:

#define SAFE FREE (p) free (p); p = NULL;

那么以下代碼:

if (NULL != p)
    SAFE_DELETE(p)
else
    .../* do something */

會(huì)被展開為:

if (NULL != P)
    free (p); p = NULL;
else
    .../* do something */

展開的代碼中存在兩個(gè)問(wèn)題:

1)因?yàn)閕f分支后有兩個(gè)語(yǔ)句,導(dǎo)致else分支沒(méi)有對(duì)應(yīng)的if,編譯失敗。

2)假設(shè)沒(méi)有else分支,則SAFE_FREE中的第二個(gè)語(yǔ)句無(wú)論if測(cè)試是否通過(guò),都會(huì)執(zhí)行。

的確,將SAFE_FREE的定義加上{}就可以解決上述問(wèn)題了,即:

#define SAFE_FREE (p) { free (p); p= NULL; }

這樣,代碼:

if (NULL != p)
    SAFE_DELETE(p)
else
    ... /* do something */

會(huì)被展開為:

if (NULL != p)
    { free (p); P = NULL; }
else
    .../* do something */

但是,在C程序中,在每個(gè)語(yǔ)句后面加分號(hào)是一種約定俗成的習(xí)慣,那么,如下代碼:

if (NULL != p)
    SAFE_DELETE (p);
else
    .... /* do something */

將被擴(kuò)展為:

if (NULL != p)
    { free (p); p = NULL; };
else
    .../* do something */

這樣else分支就又沒(méi)有對(duì)應(yīng)的if了,編譯將無(wú)法通過(guò)。

假設(shè)用了do {} while(0)語(yǔ)句,情況就不一樣了,同樣的代碼會(huì)被展開為:

if (NULL != p)
    do{ free (p); p= NULL; } while (0);
else
    .../* do something */

而不會(huì)再出現(xiàn)編譯問(wèn)題。do{} while(0)的使用完全是為了保證宏定義的使用者能無(wú)編譯錯(cuò)誤地使用宏,它不對(duì)其使用者做任何假設(shè)。

9. 其他規(guī)定

1.原則上不使用typedef，Linux認(rèn)為typedef會(huì)使可讀寫變差

2.內(nèi)聯(lián)函數(shù)通常不超過(guò)三行