1. 程式人生 > >建議 1:不要在常量和變數中出現易混淆的字母

建議 1:不要在常量和變數中出現易混淆的字母

在捧讀《編寫高質量程式碼改善Java程式的151個建議》的過程中,也一一印證這自己所遇到的問題,有所感、有所悟,所以借簡書這樣一個平臺希望和大家進行分享。

包名全小寫,類名首字母全大寫,常量全部大寫並用下劃線分割,變數採用駝峰命名法(Camel Case)命名等,這些都是最基本的Java編碼規範,是每個人Javaer都應熟知的規則,但是在變數的宣告中要注意不要引入容易混淆的字母。

猜一下,下面的程式碼列印結果是多少呢?

public class Client {
    public static void main(String[] args) {
        long i = 1l;
        System.out.println("i的兩倍是:" + (i+i));
    }
}

實踐是檢驗真理的唯一標準,不妨將程式碼放到我們的開發工具中執行一下。
參與教學工作以來特別是對於沒有基礎的同學一個bug可能需要解決很久,到頭來往往還只是一些小問題:
1、中英文標點符號使用錯誤;
2、缺少單詞;
3、如上面的問題“I”和“1”放到一塊導致的問題;
……
而在我們接下來的開發過程中所遇到的問題不乏會有這些。同樣的,在我們工作中也有可能因為如上的問題從而導致程式結果執行錯誤。所以這就要求我們規範自己的開發規範,養成良好的開發習慣。
1、應該在每個程式的開始都加上註釋,解釋該程式的目的、作者以及程式最後一次被修改的日期和時間;
2、使用空行和空格來增強程式的可讀性(Ctrl+shift+f,有的電腦型號不一樣可以自行設定);
3、駝峰式命名;
4、最好進行英文命名便於其他開發人員瞭解其含義;
……
具體的開發規範還有很多不妨參考一下《阿里巴巴開發手冊》,並且一般在我們開發之前也會就本專案進行相關規範並形成相應的文件以便進行查詢和對接。
也希望大家在接下來的工作和學習中能夠養成良好的開發規範,減少自己的錯誤,也便於對方的閱讀。