java如何加入注释

在Java中，注释用于解释代码功能或暂时禁用代码，主要分为三种类型：

单行注释

以双斜杠 // 开头，适用于简短说明或临时注释单行代码：

// 这是一个单行注释
int x = 10; // 初始化变量x

多行注释

以 /* 开始、*/ 结束，可跨越多行：

/* 
这是一个多行注释，
通常用于详细描述代码块功能。
*/
System.out.println("Hello");

文档注释

以 / 开始、*/ 结束，用于生成API文档（通过javadoc工具）：

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

注释使用场景

• 调试时临时禁用代码
• 解释复杂算法逻辑
• 为公共方法生成API文档
• 标记待完成事项（如// TODO: 优化逻辑）

文档注释支持特定标签如@param、@return、@throws等，可通过javadoc命令生成HTML格式的文档。