05、 java 的三种注释及 javadoc 命令解析文档注释(即：java 特有注释方式)的过程

java的三种注释

1、单行注释：
- 其一、代码展示：
- 其二、特点：
2、多行注释：
- 其一、代码展示：
- 其二、特点：
3、文档注释(java特有)：
- 其一、代码展示：
- 其二、注释文档的使用：
- [其三、html 页面打开注释文档：](#其三、html 页面打开注释文档：)
4、小结：

1、单行注释：

其一、代码展示：

java 复制代码

public class HelloJava{

	public static void main(String[] args){
		//单行注释：如下的语句表示输出到控制台
		//System.out.println("Hello World!")
		System.out.println("Hello World!");
	}
}

其二、特点：

A、单行注释的形式： //

B、单行注释的作用：

step1、对所写的程序进行解释说明，增强可读性。方便自己，方便别人;

step2、调试所写的代码；

C、单行注释的特点：

// 注释了的内容不参与编译(即：能调试代码的原理)

// 即：若注释该行代码后，运行程序不报错，那么就能调试代码找到报错的原因(因此：就实现了调试代码的操作);

// 换句话说：编译以后生成的 .class 结尾的字节码文件中不包含单行注释掉的信息;

2、多行注释：

其一、代码展示：

java 复制代码

public class HelloJava{
	/*
	多行注释：
	如下的main方法是程序的入口！
	main的格式是固定的！
	*/
	public static void main(String[] args){
		System.out.println("Hello World!");
	}
}

其二、特点：

A、多行注释的形式： /* */

B、多行注释的作用：

step1、对所写的程序进行解释说明，增强可读性。方便自己，方便别人;

step2、调试所写的代码；

C、多行注释的特点：

// 注释了的内容不参与编译(即：能调试代码的原理)

// 即：若注释该行代码后，运行程序不报错，那么就能调试代码找到报错的原因(因此：就实现了调试代码的操作);

// 换句话说：编译以后生成的 .class 结尾的字节码文件中不包含单行注释掉的信息;

D、注意：多行注释不可以嵌套使用

// 即：多行注释不能再嵌套多行注释使用;

// 而多行注释里面可以嵌套单行注释使用，但是感觉不必要;

3、文档注释(java特有)：

其一、代码展示：

java 复制代码

/**
文档注释
@author shkstart
@version v1.0
这是我的第一个java程序！非常的开森！

*/
public class HelloJava{

	/**
	如下的方式是main()，作用：程序的入口。
	注意：编译的时候不写 main() 函数没问题，但运行的时候不写 main() 函数就会报错，因为 main() 函数是程序的入口;
	*/
	public static void main(String[] args){
		System.out.println("Hello World!");
	}
}