一、Java 注释 在计算机语言中，注释是计算机语言的一个重要组成部分，用于在源代码中解释代码的作用，可以增强程序的可读性，可维护性。Java 注释是一种在 Java 程序中用于提供代码功能说明的文本。注释不会被编译器包含在最终的可执行程序中，因此不会影响程序的运行。注释是良好的编程习惯，它们帮助程序员更容易地理解代码的用途和功能，并且在团队协作中非常有用。Java 注释主要有三种类型： 单行注释多行注释文档注释 二、注释讲解 1、单行注释 单行注释以双斜杠//开始 2、多行注释 多行注释以/*开始，以*/结束 3、文档注释 文档注释这里大家现在简单看看就好，以后我们会继续学习的文档注释以/**开始，以*/结束，通常出现在类、方法、字段等的声明前面，用于生成代码文档，这种注释可以被工具提取并生成API文档。文档注释的格式通常包含一些特定的标签，如@param用于描述方法参数，@return用于描述返回值，@throws用于描述可能抛出的异常等等，这些标签有助于生成清晰的API文档，以便其他开发者能够更好地理解和使用你的代码。 三、注释实现 首先我们在之前建好的basic.grammar包中新建一个类Annotation，如下图： -然后我们根据刚才的注释讲解去尝试写一下注释就可以啦~~ 注释代码如下： package basic.grammar;/*** 这是一个文档注释* 它通常包含有关类、方法或字段的详细信息*/ public class Annotation {//这是一个单行注释int x = 10; //初始化一个变量x为10/*这是一个多行注释可以用来注释多行代码// 这是一个变量注释*/int y = 20; //初始化一个变量y为20 }
