Java編程那些事兒20—空白、語句結束和注釋鄭州遊戲學院 陳躍峰出自：http://blog.csdn.net/mailbomb
3.8 空白 在前面的內容中，已經介紹了在編寫代碼中，單詞和單詞之間需要使用空格進行間隔，至於空格的數量則不限制。 而實際的編碼中，為了使代碼的結構清晰，一般需要在代碼的前面加入一定數量的空格，例如如下格式： public class Blank{ public static void main(String[] args){ int n; { n = 10; } System.out.println(n); } } 在該代碼中，除了第一行和最後一行外，每行都包含一定數量的空格，這種編碼的格式稱為代碼縮排。 在實際代碼中，只要存在內含項目關聯性，則代碼就應該縮排，語句塊是最典型的內含項目關聯性之一。說明：在編譯時間，每行開始的空格都會被忽略掉。
3.9 語句結束 Java文法中，語句以“;”作為行結束符，例如： int n = 2; 通常情況下，代碼中每行唯寫一句代碼，但是也可以寫多句，例如： int n = 2; byte b = 10; 但是一般為了代碼結構清楚，只在一行中書寫一句代碼。 有些時候代碼本身比較長，則也可以把一句代碼寫在多行，而代碼語句結束的地方書寫一個“;”即可。 在實際代碼中，一般大括弧開始和結束的地方，以及大部分小括弧結束的地方都不需要書寫“;”來進行結束。
3.10 注釋 注釋(comment)是對代碼功能和用途的說明。在程式中編寫適當的注釋，將使程式碼更容易閱讀，增強代碼的可維護性。 注釋在程式編譯時間都會被忽略，所以注釋不會增加class檔案的大小。 Java語言中注釋的文法有三種：單行注釋、多行注釋和文檔注釋。
3.10.1 單行注釋 單行注釋指只能書寫一行的注釋。單行注釋屬於注釋中最簡單的文法格式，用於對於代碼進行簡單的說明，例如變數功能等。 單行注釋的文法格式為： //注釋內容 注釋以兩個斜線開始，該行後續的內容都是注釋的內容，注釋內容不能換行。 單行注釋一般書寫在需要說明的代碼的上一行，或者該行代碼的結束處，樣本結構如下： //迴圈變數 int i = 0; char sex; //性別
3.10.2 多行注釋 多行注釋指可以書寫任意多行的注釋。多行注釋一般用於說明比較複雜的內容，例如程式邏輯或演算法實現原理等。 多行注釋的文法格式為： /* 注釋內容 */ 注釋以一個斜線和一個星號開始，後續是注釋內容，注釋內容可以書寫任意多行，最後注釋以一個星號和一個斜線結尾。 很多多行注釋在每行以星號開始，這個不是文法必需的。
3.10.3 文檔注釋 文檔注釋指可以被提取出來形成程式文檔的注釋格式，這是Java語言有特色的注釋格式。一般對於程式程式的結構進行說明，例如類、屬性、方法和構造方法進行說明，這些概念在後續將詳細介紹。 文檔注釋的文法格式為： /** 注釋內容 */ 注釋以一個斜線和兩個星號開始，後續是注釋內容，注釋內容可以書寫任意多行，最後注釋以一個星號和一個斜線結尾。 在後續內容中還將完善該注釋的文法格式。
3.10.4 其它 在規範的代碼中，一般有10%-20%的注釋，也就是每100行代碼中包含10-20行注釋的內容，但是國內很多開發公司都遠遠達不到這個要求。 另外需要特別注意的是，在實際的項目開發中，在修改代碼後，一定要對應的修改注釋的內容，保持代碼和注釋內容的同步。
