“注释的种类确实不多，但还是挺有意思的，且听哥来给你说道说道。”

单行注释通常用于解释方法内某单行代码的作用。

但如果写在行尾的话，其实是不符合阿里巴巴的开发规约的。

正确的单行注释如上图中所说，在被注释语句上方另起一行，使用 注释。

    // age 用于表示年龄
    int age = 18; 
}

多行注释使用的频率其实并不高，通常用于解释一段代码的作用。

以 /* 开始，以 */ 结束，但不如用多个 // 来得痛快，因为 * 和 / 不在一起，敲起来麻烦。

// age 用于表示年纪
String name = "沉默王二";

文档注释可用在三个地方，类、字段和方法，用来解释它们是干嘛的。

PS：在 Intellij IDEA 中，按下 /** 后敲下回车键就可以自动添加文档注释的格式，*/ 是自动补全的。

接下来，我们来看看如何通过 javadoc 命令生成代码文档。

第一步，在该类文件上右键，找到「Open in Terminal」 可以打开命令行窗口。

第三步，执行 ls -l 命令就可以看到生成代码文档时产生的文件，主要是一些可以组成网页的 html、js 和 css 文件。

第四步，执行 open index.html 命令可以通过默认的浏览器打开文档注释。

点击「Demo」，可以查看到该类更具体的注释文档。

1）javadoc 命令只能为 public 和 protected 修饰的字段、方法和类生成文档。

default 和 private 修饰的字段和方法的注释将会被忽略掉。因为我们本来就不希望这些字段和方法暴露给调用者。

如果类不是 public 的话，javadoc 会执行失败。

2）文档注释中可以嵌入一些 HTML 标记，比如说段落标记 <p>，超链接标记 等等，但不要使用标题标记，比如说 <h1>，因为 javadoc 会插入自己的标题，容易发生冲突。

3）文档注释中可以插入一些 @ 注解，比如说 @see 引用其他类，@version 版本号，@param 参数标识符，@author 作者标识符，@deprecated 已废弃标识符，等等。

比如说，在使用 String 类的时候，鼠标悬停在 String 上时可以得到以下提示。

2）所有的抽象方法(包括接口中的方法)必须要用Javadoc注释、除了返回值、参数、 异常说明外，还必须指出该方法做什么事情，实现什么功能。

3）所有的类都必须添加创建者和创建日期。

Intellij IDEA 中可以在「File and Code Templates」中设置。

语法如下所示：

/**
* 微信搜索「沉默王二」，回复 Java
* @author 沉默王二

设置好后，在新建一个类的时候就可以自动生成了。

4）所有的枚举类型字段必须要有注释，说明每个数据项的用途。

5）代码修改的同时，注释也要进行相应的修改。

“好了，三妹，关于 Java 中的注释就先说这么多吧。”转动了一下僵硬的脖子后，我对三妹说。“记住一点，注释是程序固有的一部分。”

《Java 程序员进阶之路》预计一个月左右会有一次内容更新和完善，大家在我的公众号 沉默王二 后台回复“03” 即可获取最新版！如果觉得内容不错的话，欢迎转发分享！