2.1.2 Java中的注釋

注釋是對程序語言的說明，有助于開發者和用戶之間的交流，方便理解程序。注釋不是編程語句，因此會被編譯器忽略。

Java支持以下3種注釋方式。

1.單行注釋

單行注釋以雙斜杠“//”標識，只能注釋當前行內容，用在注釋信息較少的地方，如圖2-1所示。單行注釋書寫方便，所以最為常用。

2.多行注釋

多行注釋以“/*”和“*/”標識，可以注釋多行內容。為了使程序的可讀性比較好，一般首行和尾行不寫注釋信息，如圖2-2所示。

圖2-1 單行注釋

圖2-2 多行注釋

3.文檔注釋

文檔注釋以“/**”和“*/”標識，一般用在類、方法和變量上方，用來描述其作用，如圖2-3所示。文檔注釋可以使用Javadoc工具提取出來，并生成HTML幫助文件。

圖2-3 文檔注釋