java提供了3種類型的注釋
例如：
// this is a single-line comment x = 1; // a single-line comment after code
多行注釋(c風格)
java同樣提供跨越多行的注釋類型。這種類型的注釋以緊跟着一個星号的正斜杠開始，并以緊跟着一個正斜杠的星号結束。這種類型注釋的開始和結束分界符可以在同一行裡也可以在不同的行上。例如：
/* this is a c-style comment */ /* this is also a c-style comment, spanning multiple lines */
注意：c風格的注釋不可以嵌套使用。比如下面的用法：
/* a comment looks like /* this is a comment */ blah blah blah */
上面的用法會造成文法錯誤，因為java編譯器隻把第一個 */ 當做注釋來處理。(編譯器認為注釋在第一個“*/”就結束了)。
你可以在多行注釋裡嵌入單行注釋：
/* this is a single-line comment: // a single-line comment */
以及在單行注釋裡使用多行注釋：
// /* this is // a multi-line // comment */
文檔注釋
文檔注釋是一種與多行注釋很類似的特殊注釋，它可以用來為你的源代碼産生外部文檔。這種注釋以緊跟着兩個星号的正斜杠開始，并以緊跟着一個正斜杠的星号結束。例如：
/** this is a documentation comment */ /** this is also a documentation comment */
這裡有一些關于文檔注釋的重要事情要注意：
javadoc文檔生成器會把文檔注釋裡的所有文本都添加到一個html段落裡。這意味着，在文檔注釋裡的任意文本都會被格式化為一個段落;空格和換行符會被忽略。如果你想要特殊的格式，你必須要在文檔注釋裡使用html标簽。
如果文檔注釋以超過兩個的星号開始，那麼javadoc就認為這些星号是用來在源碼裡建立一個“框”框住注釋的，并忽略多餘的星号。例如：
該注釋僅保留“this is the start of a method”文本。
javadoc會忽略文檔注釋裡處于行首的星号。例如：
該注釋僅保留“this is a doc comment on multiple lines that i want to stand out in source code, looking “neat””文本。
常見的用法如下：
該用法是為了突出注釋。要注意的是，這屬于文檔注釋(即使這不是你所想的那樣)，并會在産生的文檔裡出現注釋的内容。
什麼時候使用文檔注釋
你(至少)應該在任意的公有類、接口、方法和源碼裡的類或執行個體變量前面使用文檔注釋。這樣可以讓javadoc針對代碼産生簡單的文檔，它列出了公共實體
和每個實體的簡要說明。你同樣可以在非公共方法前面使用文檔注釋，不過需要使用一個javadoc選項來它們産生文檔。相比于公有實體，在非公有實體上使
用文檔注釋顯得沒那麼重要(它的接口不會暴露出來……)。但如果你要注釋代碼，你同樣可以使用文檔注釋。
什麼時候使用單行注釋
任意時候都可以!
關于注釋，我有一個簡單的建議，在你想寫正常注釋(不是用來描述類、接口、方法或者變量的文檔注釋)的時候可以使用單行注釋。
為什麼?因為你可以輕易地使用多行注釋去“注釋掉”你的代碼段(“注釋掉代碼”意味着把一段代碼的詞法狀态變為一段注釋，讓編譯器忽略這段代碼)。舉個例子：
x = 1; /* set x to 1 */ y = 2; /* set y to 2 */ f(x, y); /* call f with x and y */
要把上面三行代碼注釋掉，你可能需要在每一行的前面使用單行注釋：
// x = 1; /* set x to 1 */ // y = 2; /* set y to 2 */ // f(x, y); /* call f with x and y */
或者在還沒有加注釋的地方加上多行注釋：
/* x = 1; */ /* set x to 1 */ /* y = 2; */ /* set y to 2 */ /* f(x, y);*/ /* call f with x and y */
或者分解或删除已存在的注釋的“結束注釋”分解符：
/* x = 1; /* set x to 1 * / y = 2; /* set y to 2 * / f(x, y); /* call f with x and y * / */
這些用法都糟糕透了。如果原始代碼使用下面的注釋，那麼事情就好辦多了：
x = 1; // set x to 1 y = 2; // set y to 2 f(x, y); // call f with x and y
如此一來，隻需使用多行注釋把代碼圍起來你就可以輕松把它注釋掉：
/* x = 1; // set x to 1 y = 2; // set y to 2 f(x, y); // call f with x and y */
在你需要使用注釋的時候盡量使用單行注釋。
什麼時候使用多行注釋
閱讀了上面的内容後，這個問題變得很明顯了。隻使用多行注釋來注釋代碼段，不要用以其他目的。
來源：51cto