单行注释(//)用于行尾注释,2. 多行注释(/…/)可跨行注释代码块,3. 文档注释(/*…/)配合javadoc生成API文档,含@param、@return等标签,提升代码可读性。

Java 中有三种注释方式,分别是单行注释、多行注释和文档注释。它们用来给代码添加说明,提高可读性,且不会被编译器执行。
1. 单行注释(//)
使用两个斜杠 // 开始,从该位置到这一行的末尾都会被当作注释内容。
// 这是一个单行注释
2. 多行注释(/* … */)
用 /* 开始,*/ 结束,中间的内容全部是注释,可以跨越多行。
立即学习“Java免费学习笔记(深入)”;
/* 这是 一个多行注释 */
/* System.out.println(“这段代码暂时不用”); */
3. 文档注释(/** … */)
以 /** 开始,*/ 结束,用于生成 API 文档。配合 javadoc 工具可提取类、方法、字段的说明。
/** * 计算两个整数的和 * @param a 第一个整数 * @param b 第二个整数 * @return 两数之和 */
public int add(int a, int b) { return a + b; }
文档注释通常写在类、方法或字段上方,支持特定标签如 @param、@return、@throws 等,帮助生成结构化文档。
基本上就这些,合理使用注释能让代码更清晰易懂。不复杂但容易忽略细节。