java - Java 注释困境

Question

这是我作业中的一个问题：

以下哪项不是可接受的表示评论的方式？为什么？

• /** 评论 */
• /* 评论 */
• // 评论
• // 评论评论
• /*评论评论*/

老实说，他们对我来说都很好。但我在想它可能是 /** comment */ 因为它在示例中不是多行的，但这就是它的目的——文档。你怎么看？这是唯一让我很难受的问题。任何帮助，将不胜感激！谢谢你。

Answer 1

从语法上看，以上所有注释的表示方式都不是不能接受的。但是，为了让其他人更容易理解您的代码，我建议遵循一些主要的编码风格。

例如，Oracle 编码风格 是 Java 流行的编码风格之一。

在其编码风格中，有两种类型的注释。第一个是实现注释，它使用 /* */ 用于块注释和 // 用于单行注释。

    /*
     * Here is a block comment.
     */


    // Here is a single line comment.

第二种是文档注释，通常使用 /** */ 样式的注释，并且只出现在类、函数和变量定义之前。例如：

    /**
     * Documentation for some class.
     */
    public class someClass {

      /**
       * Documentation for the constructor.
       * @param someParam blah blah blah
       */
      public someClass(int someParam) {
        ...
      }
      ...
    }

Answer 2

第一个子弹：

 /** comment */

这种类型的注释用于文档。来源：http: //journals.ecs.soton.ac.uk/java/tutorial/getStarted/application/comments.html

只是指出这一点，因为它与其他类型的评论不同。不过，您可能对多行注释是正确的。

Answer 3

Java 语言规范规定有两种注释，“//”和“/* ... */”。

http://docs.oracle.com/javase/specs/jls/se5.0/html/lexical.html#3.7

这是一个技巧问题。但是由于 JavaDoc 工具使用 /** ... */ 来创建 JavaDoc，所以我会说第一选择不是一个可接受的答案。

Answer 4

你应该把它放在一个java文件中并编译每个文件，然后看看哪个给你错误。您无需推理即可猜测答案。