java 代码如何注释

在Java中，有三种类型的注释：

1. 单行注释：使用`//`开始，一直延续到行尾，用于对单行代码进行解释或说明。例如：

   // 这是一个单行注释
   int x = 5; // 定义变量x并赋值为5

2. 多行注释（文档注释，也称为Javadoc风格）：使用`/* ... */`包裹，主要用于生成API文档，例如：

   /**
    * 这是一个方法的描述
    * @param name 参数名称
    * @return 返回值的描述
    */
   public void myMethod(String name) {
       // 方法体...
   }

3. Javadoc块注释：与上面的多行注释类似，但通常位于方法、类或变量上方，用于自动生成JavaDoc文档。格式为：

   /**
   * <p>这是JavaDoc块注释</p>
   *
   * <pre>
   * 示例代码:
   * MyClass obj = new MyClass();
   * obj.myMethod();
   * </pre>
   *
   * @since 1.0
   */