java 和 多行注释 文档注释 java中的多行注释

1注释的作用

通过注释提高程序的可读性，是java程序的条理更加清晰，易于区分代码行与注释行。另外通常在程序开头加入作者，时间，版本，要实现的功能等内容注释，方便后来的维护以及程序员的交流。

2注释的种类

1.单行注释（line comment）用//表示，编译器看到//会忽略该行//后的所文本
2.多行注释(block comment)用/**/表示，编译器看到/*时会搜索接下来的*/,忽略掉/**/之间的文本。
3．文档注释用/** */表示，是java特有的注释，其中注释内容可以被JDK提供的工具 javadoc 所解析，生成一套以网页文件形式体现的该程序的说明文档。

public static void main(String[] args) {

            // 第一步： 获取半径？并将半径保存在程序中
            double radius = 5;
            // 第二步：计算面积，并将面积保存在程序中
            /*
            double area = radius * radius * 3.1415;
            // 第三步：在控制台现实面积
            System.out.println("半径为" + radius + "的圆的面积为：" + area);
            */

}

注意：

多行注释中可以嵌套单行注释，多行注释不能嵌套多行注释。

class Demo{ /* 这是主函数，是程序的入口 它的出现可以保证程序的独立运行 /* 注意：多行注释嵌套多行注释是不行的。 */ */ public static void main(String[] args){ //这是输出语句用于将括号内的数据打印到控制台。 System.out.println("hello java"); }

文档注释 （编写软件说明书）

1.需要使用sum给我们提供的javadoc工具生成一个html的说明文档。
2.只能抽取public的属性或者方法内容。

格式：

常用标签

@author 作者
@param 方法的参数
@return 输出参数说明/返回值
@since JDK版本
@version 版本号
@see 链接目标
@throws 异常
@deprecated 解释
@link 链接地址

注释的使用细节：

三种注释可以出现在程序的任何地方，但是不推荐任意位置。

1. 编程习惯：

1. 给那条语句进行说明，注释应该写在该语句的旁边。
2. 单行注释一般写在语句的后面多行注释和文档注释一般写在语句的上面 注意：文档注释只能出现在类、属性、方法的上面。

2注释的嵌套

1.单行注释可以在单行注释里面。

2.多行注释不能嵌套在多行注释里面。

3 注释的调试作用:

1. 可以作为初学者的调试方式。
2. 可以帮组初学者确定代码的错误之处。

总结：

注释：

注释就是使用文字对程序的说明，注释是写给程序员看的，编译器会忽略注释的 内容的。

注释的类别：

第一种： 单行注释。 `// 注释的内容` 第二种： 多行注释。 `/* 注释的内容 */` 第三种： 文档注释。 `/** 注释的内容 */`

文档注释也是一个多行注释。

注释要注意的细节：

1. 单行注释可以嵌套使用，多行注意是不能嵌套使用的。

注释的作用：

1. 使用文字对程序说明。
2. 调试程序。

---

---