Java 注释（学习 Java 编程语言 005）

Java 中的注释不会出现在可执行程序中。因此，可以在源程序中根据需要添加任意多的注释，而不必担心可执行代码会膨胀。

在 Java 中有 3 种标记注释的方式：

1. 使用 //，注释内容从 // 开始到本行结束。
   System.out.println("Welcome to Java"); // 这就是注释

   一定要当心注释中的 \u。注释
   // \u00A0 is a newline
   会产生一个语法错误，因为读程序时 \u00A0 会替换为一个换行符。类似地，下面这个注释:
   // Look inside c:\users
   也会产生一个语法错误， 因为 \u 后面并未跟着 4 个十六进制数。

2. 使用 /* 和 */ 注释界定符将一段比较长的注释括起来。/* */ 注释不能嵌套使用。

   public class FirstSample
   {
       /* main 方法 */
       public static void main(String[] args) {
           System.out.println("Welcome to Java");
       }
   }
   

3. 以 /** 开始，以 */ 结束。

   使用该种标记注释的方式，借助 javadoc 工具可以很容易地生成 HTML 文档。

   /**
    * 这是第一个程序示例
    * @version 1.01 2020-08-24
    * @author xiang117
    */
   public class FirstSample
   {
       public static void main(String[] args) {
           System.out.println("Welcome to Java");
       }
   }