職場高薪技能：阿里初級程序員基本代碼規(guī)范

程序員想要獲得高薪和自身的技能是密不可分的，有時候既和代碼能力有關(guān)系，很多時候和代碼的簡介，明了也有直接的關(guān)系，作為一名程序員寫代碼亂糟糟的咋行呢?所以今天我將我在《阿里巴巴Java開發(fā)手冊》中看到的一些有用的、適合初級程序員的代碼基本規(guī)范，分享給大家!

1.【強制】 大括號的使用約定。如果是大括號內(nèi)為空，則簡潔地寫成{}即可，不需要換行;如果是非空代碼塊則：

1) 左大括號前不換行。

2) 左大括號后換行。

3) 右大括號前換行。

4) 右大括號后還有 else 等代碼則不換行;表示終止的右大括號后必須換行。

2.【強制】 左小括號和字符之間不出現(xiàn)空格;同樣，右小括號和字符之間也不出現(xiàn)空格。詳見第 5 條下方正例提示。

反例：if (空格 a == b 空格)

3.【強制】 if/for/while/switch/do 等保留字與括號之間都必須加空格。

4.【強制】 任何二目、三目運算符的左右兩邊都需要加一個空格。

說明：運算符包括賦值運算符=、邏輯運算符&&、加減乘除符號等。

5.【強制】 采用 4 個空格縮進，禁止使用 tab 字符。

說明：如果使用 tab 縮進，必須設置 1 個 tab 為 4 個空格。IDEA 設置 tab 為 4 個空格時，請勿勾選 Use tab character;而在 eclipse 中，必須勾選 insert spaces for tabs。

正例：(涉及上面五點)

public static void main(String[] args) { // 縮進 4 個空格 String say = "hello"; // 運算符的左右必須有一個空格 int flag = 0; // 關(guān)鍵詞 if 與括號之間必須有一個空格，括號內(nèi)的 f 與左括號，0 與右括號不需要空格 if (flag == 0) { System.out.println(say); } // 左大括號前加空格且不換行;左大括號后換行 if (flag == 1) { System.out.println("world"); // 右大括號前換行，右大括號后有 else，不用換行 } else { System.out.println("ok"); // 在右大括號后直接結(jié)束，則必須換行 } }

6.【強制】 注釋的雙斜線與注釋內(nèi)容之間有且僅有一個空格。

正例：// 注釋內(nèi)容，注意在//和注釋內(nèi)容之間有一個空格。

7.【強制】 行字符數(shù)限制不超過 120 個，超出需要換行，換行時遵循如下原則：

1) 第二行相對第一行縮進 4 個空格，從第三行開始，不再繼續(xù)縮進，參考示例。

2) 運算符與下文一起換行。

3) 方法調(diào)用的點符號與下文一起換行。

4) 方法調(diào)用時，多個參數(shù)，需要換行時，在逗號后進行。

5) 在括號前不要換行，見反例。

正例：

StringBuffer sb = new StringBuffer(); // 超過 120 個字符的情況下，換行縮進 4 個空格，點號和方法名稱一起換行 sb.append("zi").append("xin")... .append("huang")... .append("huang")... .append("huang");

反例：

StringBuffer sb = new StringBuffer(); // 超過 120 個字符的情況下，不要在括號前換行 sb.append("zi").append("xin")...append ("huang"); // 參數(shù)很多的方法調(diào)用可能超過 120 個字符，不要在逗號前換行 method(args1, args2, args3, ... , argsX);

8.【強制】 方法參數(shù)在定義和傳入時，多個參數(shù)逗號后邊必須加空格。

正例：下例中實參的"a",后邊必須要有一個空格。

method("a", "b", "c");

9.【強制】 IDE 的 text file encoding 設置為 UTF-8; IDE 中文件的換行符使用 Unix 格式，不要使用 Windows 格式。

10.【推薦】 沒有必要增加若干空格來使某一行的字符與上一行對應位置的字符對齊。

正例：

int a = 3; long b = 4L; float c = 5F; StringBuffer sb = new StringBuffer();

說明：增加 sb 這個變量，如果需要對齊，則給 a、b、c 都要增加幾個空格，在變量比較多的情況下，是一種累贅的事情。

11.【推薦】 方法體內(nèi)的執(zhí)行語句組、變量的定義語句組、不同的業(yè)務邏輯之間或者不同的語義之間插入一個空行。相同業(yè)務邏輯和語義之間不需要插入空行。

說明：沒有必要插入多個空行進行隔開。

12.【強制】 避免通過一個類的對象引用訪問此類的靜態(tài)變量或靜態(tài)方法，無謂增加編譯器解析成本，直接用類名來訪問即可。

13.【強制】 不能使用過時的類或方法。

說明：java.net.URLDecoder中的方法 decode(String encodeStr) 這個方法已經(jīng)過時，應該使用雙參數(shù) decode(String source, String encode)。接口提供方既然明確是過時接口，那么有義務同時提供新的接口;作為調(diào)用方來說，有義務去考證過時方法的新實現(xiàn)是什么。

14.【強制】Object 的 equals 方法容易拋空指針異常，應使用常量或確定有值的對象來調(diào)用equals。

正例："test".equals(object);

反例：object.equals("test");

說明：推薦使用 java.util.Objects#equals(JDK7 引入的工具類)

15.【強制】 所有的相同類型的包裝類對象之間值的比較，全部使用 equals 方法比較。

說明：對于 Integer var = ? 在-128 至 127 范圍內(nèi)的賦值，Integer 對象是在 IntegerCache.cache 產(chǎn)生，會復用已有對象，這個區(qū)間內(nèi)的 Integer 值可以直接使用==進行 判斷，但是這個區(qū)間之外的所有數(shù)據(jù)，都會在堆上產(chǎn)生，并不會復用已有對象，這是一個大坑，推薦使用 equals 方法進行判斷。

16.【強制】 構(gòu)造方法里面禁止加入任何業(yè)務邏輯，如果有初始化邏輯，請放在 init 方法中。

17.【強制】 POJO 類必須寫 toString 方法。使用 IDE 的中工具：source> generate toString時，如果繼承了另一個 POJO 類，注意在前面加一下 super.toString。

說明：在方法執(zhí)行拋出異常時，可以直接調(diào)用 POJO 的 toString()方法打印其屬性值，便于排查問題。

18.【推薦】 使用索引訪問用 String 的 split 方法得到的數(shù)組時，需做最后一個分隔符后有無內(nèi)容的檢查，否則會有拋 IndexOutOfBoundsException 的風險。

說明：

String str = "a,b,c,,"; String[] ary = str.split(","); // 預期大于 3，結(jié)果是 3System.out.println(ary.length);

19.【推薦】 當一個類有多個構(gòu)造方法，或者多個同名方法，這些方法應該按順序放置在一起，便于閱讀，此條規(guī)則優(yōu)先于第 15 條規(guī)則。

20.【推薦】 類內(nèi)方法定義順序依次是：公有方法或保護方法 > 私有方法 > getter/setter方法。

說明：公有方法是類的調(diào)用者和維護者最關(guān)心的方法，首屏展示最好;保護方法雖然只是子類關(guān)心，也可能是“模板設計模式”下的核心方法;而私有方法外部一般不需要特別關(guān)心，是一個黑盒實現(xiàn);因為承載的信息價值較低，所有 Service 和 DAO 的 getter/setter 方法放在類體最后。

21.【推薦】 setter 方法中，參數(shù)名稱與類成員變量名稱一致，this.成員名 = 參數(shù)名。在getter/setter 方法中，不要增加業(yè)務邏輯，增加排查問題的難度。

反例：

public Integer getData() { if (true) { return this.data + 100; } else { return this.data - 100; } }

22.【推薦】 循環(huán)體內(nèi)，字符串的連接方式，使用 StringBuilder 的 append 方法進行擴展。

說明：反編譯出的字節(jié)碼文件顯示每次循環(huán)都會 new 出一個 StringBuilder 對象，然后進行append 操作，最后通過 toString 方法返回 String 對象，造成內(nèi)存資源浪費。

反例：

String str = "start"; for (int i = 0; i < 100; i++) { str = str + "hello"; }

23.【推薦】 final 可以聲明類、成員變量、方法、以及本地變量，下列情況使用 final 關(guān)鍵字：

1) 不允許被繼承的類，如：String 類。

2) 不允許修改引用的域?qū)ο?，如：POJO 類的域變量。

3) 不允許被重寫的方法，如：POJO 類的 setter 方法。

4) 不允許運行過程中重新賦值的局部變量。

5) 避免上下文重復使用一個變量，使用 final 描述可以強制重新定義一個變量，方便更好地進行重構(gòu)。

24.【強制】 中括號是數(shù)組類型的一部分，數(shù)組定義如下：String[] args;

25.【強制】 POJO類中布爾類型的變量，都不要加is，否則部分框架解析會引起序列化錯誤;

26.【推薦】 除常用方法(如 getXxx/isXxx)等外，不要在條件判斷中執(zhí)行其它復雜的語句，將復雜邏輯判斷的結(jié)果賦值給一個有意義的布爾變量名，以提高可讀性。

說明：很多 if 語句內(nèi)的邏輯相當復雜，閱讀者需要分析條件表達式的最終結(jié)果，才能明確什么樣的條件執(zhí)行什么樣的語句，那么，如果閱讀者分析邏輯表達式錯誤呢?

正例：// 偽代碼如下：

final boolean existed = (file.open(fileName, "w") != null) && (...) || (...); if (existed) { ... }

27.【強制】 在 if/else/for/while/do 語句中必須使用大括號。即使只有一行代碼，避免采用單行的編碼方式：if (condition) statements;

28.【推薦】類內(nèi)方法定義順序依次是：公有方法或保護方法>私有方法>getter/setter方法;

說明：公有方法是類的調(diào)用者和維護者最關(guān)心的方法，首屏展示最好;保護方法雖然只是子類關(guān)心，也可能是“模板設計模式”下的核心方法;而私有方法外部一般不需要特別關(guān)心，是一個黑盒實現(xiàn);因為承載的信息價值較低，所有 Service 和 DAO 的 getter/setter 方法放在類體最后。

仔細看下來，是不是覺得其實也沒有那么難懂，但會了這些，阿里要你的概率就加大了哦。我們的第一目標就是進入阿里不是么?

其實在職業(yè)發(fā)展的后期，工資僅僅是零花錢了，更重要的是股權(quán)激勵。即使月薪相差1萬，10年的差別還不夠在北京付個首付。但是阿里上市，成就了多少千萬富翁!

與其對未來充滿迷茫，不如來達內(nèi)學習一門好技術(shù)改變?nèi)松?。只要你想，夢想就一定會實現(xiàn)。達內(nèi)喜歡懷揣夢想的你，目前達內(nèi)推出1月免費體驗營，如果你比較迷?？梢詠磉_內(nèi)體驗營感受一下，也可以找到自己的方向。