一、注释格式分类：

　　1、单行(single-line)注释：//……

　　2、块(block)注释：/*……*/

　　3、文档注释：/**……*/

　　javadoc有如下：

　　

 

二、加注释的场景：

　　1. 基本注释（必须加）

　　　　(a)类（接口）的注释

　　　　(b)构造函数的注释

　　　　(c)方法的注释

　　　　(d)全局变量的注释

　　　　(e)字段/属性的注释

　　2. 特殊必须加注释（必须加）

　　　　(a)典型算法 必须有注释。

　　　　(b)在代码不明晰处必须有注释。

　　　　(c)在代码修改处加上修改标识的注释。

　　　　(d)在循环和逻辑分支组成的代码中加注释。

　　　　(e)为他人提供的接口必须加详细注释。

三、注释示例

　　　　类的注释——请使用IDE的模板定义类注释模板

/** * 测试类 * @author  * @version 1.0 *  * */public class Test01 {

 

private String username;//用户名，字段属性注释

　　　　全局变量注释

　　/**统计次数*/    private final int count= 18;

　　　　方法注释

　　/**     * 测试方法     * @param n 循环次数     *      */    @Test    public void fun1(int n){