评论公约

Pat*_*ell 9 java comments

我想知道评论的准则是什么?我正在用Java编写课程.我希望有可读的代码.在另一个问题中,我被告知"如何"应该为困难的代码段保留注释.有人告诉我,我的代码评论没有添加任何已知信息.评论不仅适用于读者.它们还提醒作者他们的原始意图并帮助匹配分组符号.

我是Java和Stackoverflow的新手.为什么我变得贪婪?我认为这个网站旨在让程序员互相帮助.我觉得自己是一个目标,因为我有一个-3投票的问题.我们在这里是为了帮助新的程序员还是在这里以自己的费用为荣?

And*_*rew 8

不同的人有不同的风格,所以在某种程度上你在这里读到的只是某人的建议.评论没有冷酷,严格的规则.

关于Java注释,你应该知道的最重要的事情是Javadocing.这是一种特殊类型的注释,可以在IDE(如Eclipse和Netbeans)中进行解析和使用,以帮助简化编码过程.Javadoc注释以/**开头,以*/结尾,就像常规的多行注释一样,但在第一个注释中有两个星号.

您将Javadoc注释放在类,方法或实例变量的开头,以描述它们的作用.有一些标准方法可以在注释中格式化数据,这些是标记.一些常见的标签是@author和@version.您可以在此处查看Sun关于编写Javadoc注释的一些建议:http://java.sun.com/j2se/javadoc/writingdoccomments/

之后我喜欢做的是使用单行注释(双斜杠//)来描述我的逻辑.如果我需要多行,我将只使用多个单行注释.这种技术的优点是,如果您需要稍后注释掉大量文本,您可以使用常规多行注释/**/而无需担心嵌套注释问题.

我希望这可以帮助您大致了解如何在java中使用注释.我的建议部分是我在大学的Intro Java课程中获得的助教工作的一部分,部分来自于在工业界工作.其他背景不同的人可能会有更多建议.