本節書摘來自異步社群《java和android開發實戰詳解》一書中的第2章,第2.5節良好的java程式代碼編寫風格,作者 陳會安,更多章節内容可以通路雲栖社群“異步社群”公衆号檢視
2.5 良好的java程式代碼編寫風格
java和android開發實戰詳解
java代碼是由程式語句組成的,數個程式語句組合成一個程式塊,每一個塊擁有數行程式語句或注釋,一行程式語句是一個表達式、變量和指令的程式代碼。
2.5.1 程式語句
java程式由程式語句(statement)組成,一行程式語句如同英文的一個句子,内含多個表達式、運算符或java關鍵字(詳見第3章的說明)。
1.程式語句的範例
一些java程式語句的範例,如下所示:
2.程式語句結束符号“;”
“;”符号代表程式語句的結束,它告訴編譯器已經到達程式語句的最後。換句話說,我們可以使用“;”符号在同一行編寫多個程式語句,如下所示:
上述一行代碼即擁有3個程式語句。
2.5.2 程式塊
程式塊(block)是多條程式語句的一個集合,使用“{”和“}”符号包圍起來,如下所示:
上述main()方法中的代碼部分是一個程式塊,在第4章和第5章将介紹的流程控制語句和方法都擁有程式塊。
java語言屬于一種“自由格式”(free-format)的程式語言,我們可以将多個程式語句寫在同一行,甚至也可以将整個程式塊置于同一行,程式設計者可以自由編排程式代碼,如下所示:
2.5.3 程式注釋
程式注釋是程式的重要部分,因為良好的注釋文字不但有助于了解程式的目的,并且在程式維護上,也可以提供更多的資訊。
java語言的程式注釋是以“//”符号開始的行,也可以将它們放在程式行後,如下所示:
system.out.println("第一個java程式"); // 顯示資訊
如果注釋文字較長,需要跨多行,我們可以使用“/”和“/”符号标示注釋文字,如下所示:
2.5.4 避免太長的程式代碼
如果一條語句的程式代碼太長,基于易于閱讀的需求,我們可以将它分成兩列來編排。因為java語言屬于自由格式的程式語言,并不需要使用任何符号,直接分成兩行即可,如下所示:
不過在程式代碼分割時需要保持程式元素的完整性,例如:關鍵字、完整字元串或運算符,請注意!不可以将一個字元串斷開分成兩行。
2.5.5 程式代碼縮排
記得使用縮排程式代碼。适當地縮排代碼,可以讓程式更加容易閱讀,并且容易反映出程式代碼的邏輯結構。例如:将循環塊中的程式代碼縮幾格編排,如下所示:
向内縮排可以清楚分辨哪些程式代碼屬于同一個程式塊。事實上,程式編寫風格并非一成不變,程式設計者可以自己定義所需的程式編寫風格。