Java语言注释有三种:

单行注释,多行注释,与文档注释。

注释作用一:

一般情况下Java不允许出现中文以及其他不符合规范的提示性文字,但有时代码过多过于复杂,这时就需其他文字辅助进行说明,增强代码的可读性,或者这时就需要注释来帮忙。

作用二:当我们调试代码时,暂时不想让某行代码执行,删除重写太麻烦,我们这时就可以把代码注释了,当需要时在恢复。

1,单方注释形式:  //  注释内容

快捷键用法:选择要注释的内容      ctrl键加     / 键

适用范围:可插入任意范围(类中,循环中,方法体内类体外)且注释内容较少时

注意:    单行注释内容前必须有正斜杠  //

2,多行注释形式 :   /*      注释内容       

                                     注释内容           */

快捷键用法:选择要注释的内容   ctrl 键加 shift键 加  /  键

适用范围:同单行注释一样!

注意:  多行注释必须以 /*  符号开头     以*/ 符号结尾 ,多行注释可以嵌套单行注释,但是不能嵌套多行注释和文档注释。

3,文档注释形式:  /**        注释内容

                                  **/结尾

适应范围:包含在“/**”和“*/”之间,也能注释多行内容,一般用在类、方法和变量上面,用来描述其作用。注释后,鼠标放在类和变量上面会自动显示出我们注释的内容,

文档注释可以通过 Javadoc 命令把文档注释中的内容生成文档,并输出到 HTML 文件中,方便记录程序信息。还可以包含一个或多个 @ 标签,每个 @ 标签都在新的一行开始

注意:文档注释能嵌套单行注释,不能嵌套多行注释和文档注释,一般首行和尾行也不写注释信息。

更多推荐