4 - 縮進(jìn)

UsherChen 發(fā)布于2019-08-15 17:43 / 1297人閱讀

摘要：縮進(jìn)推薦使用個(gè)空格做為縮進(jìn)單位。換行縮進(jìn)區(qū)別代碼嵌套內(nèi)部需要縮進(jìn)。比如如果上述規(guī)則導(dǎo)致代碼混淆或超過右邊的邊界，則只需縮進(jìn)個(gè)空格即可。優(yōu)選操作符前面避免下面是個(gè)縮進(jìn)方法聲明的示例。

4 - 縮進(jìn)

推薦使用4個(gè)空格做為縮進(jìn)單位。
關(guān)于使用空格或者tab并沒有決定性的要求。tab需要設(shè)置為8個(gè)空格而不是4個(gè)。

Q:  換行、縮進(jìn) 區(qū)別  
A:  代碼嵌套、內(nèi)部需要縮進(jìn)。比如方法的實(shí)現(xiàn)和if的內(nèi)部，如下：

if (boolenArg) {
    doSomething(); //這叫縮進(jìn) 4個(gè)空格
}

var longName1 = longName2 + longName3 + longName4 + longName5
               + longName6;  //這叫換行 太長(zhǎng)了換了第二行

4.1 行長(zhǎng)

避免超過80個(gè)字符的行，因?yàn)楹芏嘟K端和工具不能很好的處理它們。

Note: 注釋中使用的示例應(yīng)該具有較短的行長(zhǎng), 一般不超過70個(gè)字符

4.2 換行規(guī)則

當(dāng)一個(gè)表達(dá)式不適合多帶帶一行時(shí)，根據(jù)以下一般原則將它分解：

逗號(hào)之后

操作符前面

優(yōu)選在高級(jí)別的運(yùn)算后面換行

將新行與上一行中相同級(jí)別的表達(dá)式的開頭對(duì)齊。比如(、)、[、]

如果上述規(guī)則導(dǎo)致代碼混淆或超過右邊的邊界，則只需縮進(jìn)8個(gè)空格即可。

參考案例：

someMethod(longExpression1, longExpression2, longExpression3,
        longExpression4, longExpression5); // 逗號(hào)后面  8個(gè)空格
        
var = someMethod1(longExpression1,
                someMethod2(longExpression2,
                        longExpiression3)); // 16個(gè)空格，因?yàn)槭欠椒▋?nèi)部的函數(shù)

下面是2個(gè)算術(shù)運(yùn)算的換行例子。第一個(gè)是優(yōu)選的，因?yàn)樗鼡Q行是在高級(jí)別的運(yùn)算外面。

longName1 = longName2 * (longName3 + longName4 - longName5)
           + 4 * longName6; //優(yōu)選 操作符前面

longName1 = longName2 * (longName3 + longName4
                      - longName5) + 4 * longName6; //避免

下面是2個(gè)縮進(jìn)方法聲明的示例。第一個(gè)是常規(guī)換行。第二個(gè)例子中如果按照常規(guī)換行會(huì)太
緊貼右邊，所以只前置了8個(gè)空格。

//常規(guī)換行 括號(hào)對(duì)齊
someMethod(int anArg, Object anotherArg, String yetAnotherArg,
           Object andStillAnother) {
    //do something               
}

// 縮進(jìn)8個(gè)空格 避免很長(zhǎng)的縮進(jìn).
// 這種情況，如果也使用括號(hào)對(duì)齊的話，右邊都沒辦法寫代碼了
private static synchronized horkingLongMethodName (int anArg,
        Object anotherArg, String yetAnotherArg,
        Object andStillAnother) {
    // do something            
}

if 表達(dá)式的換行應(yīng)該使用8個(gè)空格，因?yàn)?個(gè)空格會(huì)讓表達(dá)式的內(nèi)部的代碼很不容易區(qū)分，例如：

// 不要使用這種縮進(jìn)
if ((condition1 && condition2)
    || (condition3 && condition4)
    ||!(condition5 && condition6)) { //錯(cuò)誤寫法
    doSomethingAboutIt();        // 這行很容易被忽略
}

// 推薦使用
if ((condition1 && condition2)
        || (condition3 && condition4)
        ||!(condition5 && condition6)) {
    doSomethingAboutIt();            
}

// 或者使用
if ((condition1 && condition2) || (condition3 && condition4)
        ||!(condition5 && condition6)) {
    doSomethingAboutIt();            
}

以下是三種可接受的方式來設(shè)置三元表達(dá)式的格式：

alpha = (aLongBooleanExpression) ? beta : gamma;

alpha = (aLongBooleanExpression) ? beta
                                 : gamma;

alpha = (aLongBooleanExpression)
        ? beta
        : gamma;