1.行長(zhǎng)度
每一行代碼字符數(shù)不超過(guò)80
結(jié)論:80個(gè)字符是最大值躏仇。例外:
1)如果一行注釋包含了超過(guò)80個(gè)字符的,命令或者URL腺办,出于復(fù)制粘貼的方便可以超過(guò)80個(gè)
2)頭文件保護(hù)
2.非ASCII字符
盡量不要使用非ASCII字符焰手,使用時(shí)必須使用UTF-8格式
3.空格還是制表位
只使用空格,每次縮進(jìn)2個(gè)空格
可以設(shè)定編輯器將tab轉(zhuǎn)為空格
4.函數(shù)聲明與定義
返回類型和函數(shù)名在同一行怀喉,合適的話书妻,參數(shù)也放在同一行
以下幾點(diǎn):
1)返回值和函數(shù)名總是在同一行
2)左圓括號(hào)總是核函數(shù)名在同一行
3)函數(shù)名和左圓括號(hào)間沒(méi)有空格
4)圓括號(hào)和參數(shù)間沒(méi)有空格
5)左大括號(hào)總是在最后一個(gè)參數(shù)同一行的末尾處
6)右大括號(hào)總是單獨(dú)位于函數(shù)最后一行
7)右圓括號(hào)和左大括號(hào)之間總是有一個(gè)空格
8)函數(shù)聲明和實(shí)現(xiàn)處的所有形參名稱必須保持一致
9)所有形參應(yīng)該盡可能對(duì)齊
10)缺省縮進(jìn)為2個(gè)空格
11)獨(dú)立封裝的參數(shù)保持4個(gè)空格的縮進(jìn)
5.函數(shù)調(diào)用
盡量放在同一行,否則磺送,將實(shí)參封裝在圓括號(hào)中驻子。
同一行放不下灿意,可斷為多行,后面每一行都和第一個(gè)實(shí)參對(duì)齊崇呵,左圓括號(hào)和右圓括號(hào)前不要留空格:
bool retval = DoSomething(argument1,
argument2,
argument3);
or
if{
if{
DoSomethingThatRequiresALongFunctionName(
very_long_argumrnt1,
argument2,
argument3
);
}
}
6.條件語(yǔ)句
更提倡不在圓括號(hào)中添加空格缤剧,關(guān)鍵字else另起一行。
圓括號(hào)和大括號(hào)最好空一格
if(condition) {...
有些語(yǔ)句放在一行域慷,增強(qiáng)可讀性
if(x) DoThis();
通常單行語(yǔ)句不要使用大括號(hào)
7.循環(huán)和開(kāi)關(guān)選擇語(yǔ)句
switch語(yǔ)句可以使用大括號(hào)分塊荒辕;空循環(huán)提應(yīng)使用{}或continue,不要只是一個(gè)建立單的分號(hào)犹褒。
switch語(yǔ)句中的case塊可以使用大括號(hào)也可以不用抵窒,如果輸入的值沒(méi)有case去處理,編譯器將會(huì)報(bào)警叠骑,因此添加default李皇,若default永不會(huì)執(zhí)行,可以簡(jiǎn)單地使用assert:
default:{
assert(false); //assert判斷為假中斷程序執(zhí)行
}
8.指針和引用表達(dá)式
句點(diǎn)(.)或箭頭(->)前后不要有空格宙枷,指針/地址操作符(*掉房, &)后不要有空格
9.布爾表達(dá)式
如果一個(gè)布爾表達(dá)式超過(guò)標(biāo)準(zhǔn)行寬(80字符),如果斷行要統(tǒng)一
10.函數(shù)返回值
return表達(dá)式中不要使用圓括號(hào)
11.變量及數(shù)組初始化
選擇=還是()慰丛。都可以
12.預(yù)處理指令
預(yù)處理指令不要縮進(jìn)卓囚,從行首開(kāi)始(即使預(yù)處理指令在縮進(jìn)的代碼塊中)
if(condition){
if DISASTER_PENDING
...
endif
...
}
13.類格式
聲明屬性依次是public、protected诅病、private哪亿。每次縮進(jìn)一個(gè)空格。
class MyClass{
public:
...
}
注意:
1)所有基類名應(yīng)在80列限制下盡量與子類名放在同一行
2)關(guān)鍵詞public 贤笆。蝇棉。。 要縮進(jìn)1個(gè)空格(MSVC所使用tab縮進(jìn)苏潜,且這三個(gè)關(guān)鍵詞不縮進(jìn))
3)除了第一個(gè)關(guān)鍵詞之外银萍,其他關(guān)鍵詞前空一行变勇。類小的話可以不空
4)這些關(guān)鍵詞之后不要空行
14.初始化列表
構(gòu)造函數(shù)初始化列表放在同一行或按四格縮進(jìn)并排幾行
MyClass::MyClass(int var):some_var_(var), some_other_var_(var + 1){
或者
MyClass::MyClass(int var)
:some_var_(var),
some_other_var_(var + 1){
15.命名空間格式化
命名空間內(nèi)容不要縮進(jìn)恤左。
namespace{
void foo() {
}
}
16.水平空白
水平空白的使用因地制宜,不要在行尾提那家無(wú)謂的空白
17.垂直空白
垂直空白越少越好
總結(jié):
1)行寬原則上不超過(guò)80列
2)盡量不要使用ASCII字符搀绣,要用的話飞袋,參考UTF-8格式,尤其在linux链患、unix下巧鸭。盡量不要將字符串常量耦合到代碼中,比如可以獨(dú)立出資源文件
3)UNIX/Linux無(wú)條件使用空格麻捻,MSVC的話使用tab也無(wú)可厚非
4)函數(shù)參數(shù)纲仍,邏輯條件呀袱、初始化列表:要么所有參數(shù)和函數(shù)名放在同一行,要么所有參數(shù)并排分行
5)除函數(shù)定義的左大括號(hào)可以置于行首外郑叠,包括函數(shù)夜赵、類、結(jié)構(gòu)體乡革、枚舉聲明寇僧。各種語(yǔ)句的左大括號(hào)置于行尾,所有右大括號(hào)獨(dú)立成行
6).or->操作符前后不留空沸版,*or&不要前后都留空嘁傀,一個(gè)就可,靠左靠右依個(gè)人愛(ài)好
7)預(yù)處理和命名空間不要使用額外縮進(jìn)视粮,類细办、結(jié)構(gòu)體、枚舉蕾殴。函數(shù)蟹腾。語(yǔ)句使用縮進(jìn)
8)初始化=還是()都可以
9)return不要加()
10)水平,垂直留白不要濫用区宇,怎么易讀怎么來(lái)