在 Java 中，注释用于解释代码的功能、提供额外的信息或者将代码暂时禁用。注释不会被编译器执行，它们只是为了让代码更易于理解和维护。Java 中有三种类型的注释：

1. 单行注释（Single-line Comment）

单行注释以 // 开头，注释的内容从 // 到行尾。

示例：

   // 这是一个单行注释
   int x = 10; // 这是行尾的注释

2. 多行注释（Multi-line Comment）

多行注释以 /* 开始，以 */ 结束。它可以注释多行内容，适用于较长的注释块。

示例：

   /* 这是一个多行注释
      可以注释多行内容
      直到遇到结束符 */
   int x = 10;
   int y = 20;

3. 文档注释（Javadoc Comment）

Javadoc 注释用于生成 API 文档，通常用 /** 开始，*/ 结束。Javadoc 是一种特殊的多行注释，专门用于描述类、方法和字段等，生成的文档可以帮助开发人员理解代码的功能和使用方法。

示例：

   /**
    * 计算两个整数的和。
    * @param a 第一个整数
    * @param b 第二个整数
    * @return 两个整数的和
    */
   public int add(int a, int b) {
       return a + b;
   }

这里，@param 用于描述方法参数，@return 描述返回值。Javadoc 注释可以通过 Javadoc 工具生成 HTML 格式的文档，便于查看和使用。

总结：

• 单行注释：适用于简单的解释或行尾注释。
• 多行注释：适用于较长的注释块。
• 文档注释：用于生成 API 文档，帮助开发者理解代码。

在实际开发中，通常会混合使用这三种注释，以保持代码的可读性和维护性。如果你想生成文档或者在方法、类上添加详细的注释，Javadoc 注释是非常有用的。

更多详细内容请关注其他相关文章。