java - 注释/* */和/** */之间的区别？

Question

这个问题已经有答案了:

Difference between green and blue comments in eclipse (4 个回答)

已关闭 10 年前。

eclipse中下面的注释有什么区别:

1. /后接一个 *

   /*评论...*/

2. /后跟两个 **

   /**评论...*/

两条评论的颜色也不同。当我们使用第二个^nd类型注释时，它会自动显示 @author姓名。为什么会这样？

Answer 1

/** */ 注释是 javadoc评论，更多详细信息here :

Documentation comments (doc comments)

The special comments in the Java source code that are delimited by the /** ... */ delimiters. These comments are processed by the Javadoc tool to generate the API docs.

它们的特定格式允许某些工具构建 API 文档，例如 the one you see of the standard package而且，如果您运行它，还可以使用您自己的代码。它可以让您以正式的方式描述参数、返回的内容等。

该文档不仅会在您生成文档时呈现给您(以 HTML 或其他格式)，还会以多种方式呈现在 IDE(如 Eclipse)中，例如当您的鼠标悬停在某些名称上时。在 javadoc 中编写方法和类的用户所需的重要信息(仅是有用的信息)是一个重要的好习惯。

<小时/>

值得一提的是 /* */ 不仅对于注释多行很有用。考虑一下当您想要注释掉 if 条件内的某些内容时的情况:

if(a==b && c == d)

然后，如果您想删除 a==b 并稍后将其放回去，则不能使用 // 因为它会注释掉整个内容在它后面一行，所以你这样做:

if(/*a==b &&*/ c == d)

顺便说一句，这与 Eclipse 无关，这是 Java 功能。