扫二维码关注公众号

来源：网络整理     时间：2023/2/17 15:13:05    共 3659 浏览

注释是对程序语言的说明，有助于开发者和用户之间的交流，方便理解程序。注释不是编程语句，因此被编译器忽略。

Java 支持以下三种注释方式：

1）单行注释

以双斜杠“//”标识，只能注释一行内容，用在注释信息内容少的地方。打开 Eclipse，在 Java 代码中使用单行注释，如图 1 所示。


图 1  单行注释

2）多行注释

包含在“/*”和“*/”之间，能注释很多行的内容。为了可读性比较好，一般首行和尾行不写注释信息（这样也比较美观好看），如图 2 所示。

注意：多行注释可以嵌套单行注释，但是不能嵌套多行注释和文档注释。


图 2  多行注释

3）文档注释

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

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


图 3  文档注释
文档注释可以通过 Javadoc 命令把文档注释中的内容生成文档，并输出到 HTML 文件中，方便记录程序信息。还可以包含一个或多个 @ 标签，每个 @ 标签都在新的一行开始。关于 Javadoc 的具体标签和使用可阅读学习《Javadoc入门教程》一节。

在 Java 中，一行注释以双斜杠“//”标识；多行注释包含在“/*”和“*/”之间；文档注释包含在“/**”和“*/”之间。当编译器执行到“//”时，就会忽略该行“//”之后的所有文本；当执行到“/*”时，会扫描下一个“*/”并忽略“/*”和“*/”之间的任何文本；当执行到“/**”时，也会扫描下一个“*/”并忽略“/**”和“*/”之间的任何文本内容。

版权说明：
本网站凡注明“广州京杭 原创”的皆为本站原创文章，如需转载请注明出处！
本网转载皆注明出处，遵循行业规范，如发现作品内容版权或其它问题的，请与我们联系处理！
欢迎扫描右侧微信二维码与我们联系。

·上一条：Python range()快速初始化数字列表 | ·下一条：Java标识符和关键字

同类资讯

• Python range()快速初始化数字列表
• Java程序员必须知道的学习路线
• 使用Eclipse开发第一个Java程序
• JS正则表达式语法大全（非常详细）
• Java常用开发工具有哪些？
• Java初学者容易犯的错误
• Python None（空值）及用法
• JS获取数组长度（length属性）
• Java变量的作用域：静态变量、全局变量和局部变量
• Python字符串对齐方法（ljust()、rjust()和center
• JS截取数组：使用splice()和slice()方法
• JS数组排序：使用reverse()和sort()方法
• JS遍历数组（for in和forEach循环）
• Java数据类型：基本数据类型和引用数据类型
• JS数组转字符串（3种方法）
• JS判断是否是数组：使用isArray()方法
• JS every()方法：检测数组元素是否全部符合指定条件
• Python eval()和exec()函数详解
• 什么是文件路径，Python中如何书写文件路径？
• Python绝对路径和相对路径详解