java - 先注释还是屏蔽评论？（评论风格）

Question

/* Prints the coordinate */
@Override
public String toString() {
    return new StringBuilder("(").append(x).append(",").append(y).append(",").append(z).append(")").toString();
}

在上面的示例中，该方法的注释排在第一位。这是通常的做法，还是相反的做法？

Answer 1

虽然这完全是一个选择的问题，或者说将由团队编码约定决定，但我个人觉得跟随一个看起来更好、更有表现力：

/**
  comments
  .... 
*/
@Annotation
type method(){
    ...
    ...
 }