Java 中的注释有哪些？-Toy模板网

这篇具有很好参考价值的文章主要介绍了Java 中的注释有哪些？。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

在 Java 中，有三种注释方式：单行注释、多行注释和文档注释。注释是程序中的一种重要的辅助性说明文字，可以增加程序的可读性和可维护性，方便其他程序员阅读和理解代码。

单行注释单行注释是指以“//”开头的注释，注释从“//”开始一直到该行的末尾。例如：

arduinoCopy code

// This is a single-line comment

单行注释通常用来对代码进行短暂的说明，或者是对代码进行临时的注释或调试。

多行注释多行注释是指以“/”开头，以“/”结尾的注释。多行注释可以跨越多行，中间可以包含任意数量的代码和空白行。例如：

arduinoCopy code

/* * This is a multi-line comment. * It can span multiple lines. */

多行注释通常用来对代码进行详细的解释和说明，或者是暂时注释掉一段代码。

文档注释文档注释是一种特殊的注释，它以“/**”开头，以“*/”结尾，用于为 Java 类、方法和变量生成 API 文档。文档注释可以包含多行的 HTML 标记和文本。例如：

kotlinCopy code

/** * This class represents a person. * * <p>It has a name and an age.</p> * * <pre>{@code * Person person = new Person("Alice", 30); * }</pre> */ public class Person { // class implementation }

文档注释通常用于为 API 自动生成文档，方便其他程序员使用和了解该 API 的使用方式、参数、返回值等信息。

在编写 Java 程序时，注释是很重要的，它可以让程序更加易读、易懂，也可以提高程序的可维护性和可重用性。因此，程序员在编写代码时应该注意添加适当的注释，使代码更加清晰易懂。

Javadoc 标记是指一组特殊的注释标记，用于生成文档注释。它以“@”符号开头，后面跟着一个标记名称和对应的内容。常用的 Javadoc 标记包括：

@param：用于描述方法的参数。例如：@param name the name of the person
@return：用于描述方法的返回值。例如：@return the age of the person
@throws：用于描述方法可能抛出的异常。例如：@throws IllegalArgumentException if the age is negative
@deprecated：用于标记该方法已经被废弃。例如：@deprecated This method is deprecated and should not be used.
@see：用于引用其他类或方法。例如：@see Person#getName()