Java 中的注释不会出现在可执行程序中。因此,可以在源程序中根据需要添加任意多的注释,而不必担心可执行代码会膨胀。
在 Java 中有 3 种标记注释的方式:
-
使用 //,注释内容从 // 开始到本行结束。
System.out.println("Welcome to Java"); // 这就是注释
一定要当心注释中的 \u。注释
// \u00A0 is a newline
会产生一个语法错误,因为读程序时 \u00A0 会替换为一个换行符。类似地,下面这个注释:
// Look inside c:\users
也会产生一个语法错误, 因为 \u 后面并未跟着 4 个十六进制数。 -
使用 /* 和 */ 注释界定符将一段比较长的注释括起来。
/* */
注释不能嵌套使用。public class FirstSample { /* main 方法 */ public static void main(String[] args) { System.out.println("Welcome to Java"); } }
-
以 /** 开始,以 */ 结束。
使用该种标记注释的方式,借助 javadoc 工具可以很容易地生成 HTML 文档。
java /** * 这是第一个程序示例 * @version 1.01 2020-08-24 * @author xiang117 */ public class FirstSample { public static void main(String[] args) { System.out.println("Welcome to Java"); } }