Question

我发现，在日食中，

/*
 * Hello world, this is green.
 *
 */

评论将为绿色。然而，

/**
 * Hello moon, this is blue.
 *
 */

如果我使用/ **，它将变为蓝色。所以为什么？有什么不同吗？

Answer 1

/*启动常规多行评论时，/**会启动支持javadoc tool的多行评论，该评论会根据您的评论生成HTML文档。

这是一个示例from the documentation：

/**
 * Returns an Image object that can then be painted on the screen. 
 * The url argument must specify an absolute {@link URL}. The name
 * argument is a specifier that is relative to the url argument. 
 * <p>
 * This method always returns immediately, whether or not the 
 * image exists. When this applet attempts to draw the image on
 * the screen, the data will be loaded. The graphics primitives 
 * that draw the image will incrementally paint on the screen. 
 *
 * @param  url  an absolute URL giving the base location of the image
 * @param  name the location of the image, relative to the url argument
 * @return      the image at the specified URL
 * @see         Image
 */
public Image getImage(URL url, String name) {
    try {
        return getImage(new URL(url, name));
    } catch (MalformedURLException e) {
        return null;
    }
}

The Java API specification itself是通过javadoc生成的HTML文档示例。

Answer 2

以/*开头的评论是正常的代码评论。这些通常用在代码行之上来描述逻辑。

以/**开头的注释用于javadoc。这些用于方法和类

Answer 3

/ *只是一条多行注释。

/ **适用于Javadoc，它允许您为用户提供更具可读性的文档。

看看

Javadoc

Answer 4

虽然/**评论启动程序适用于javadoc，但从技术上讲，它们实际上从编译器的角度来看是相同的。评论是评论是评论。这里的重要部分是/**为/*并添加了额外的星号。

Answer 5

/* text */：编译器会忽略从/*到*/

的所有内容

<强> /** documentation */ 这表示文档评论（简称doc评论）。编译器会忽略这种注释，就像忽略使用/ *和* /的注释一样。 JDK javadoc工具在准备自动生成的文档时使用doc注释。有关javadoc的更多信息，请参阅Java工具documentation

/ *和/ **之间的区别

5 个答案: