​
​

活动地址：CSDN21天学习挑战赛

学习的最大理由是想摆脱平庸，早一天就多一份人生的精彩；迟一天就多一天平庸的困扰。各位小伙伴，一起加油吧！

什么是注释？

🌴 简单来说，注释就是对一段代码的解释说明，帮助我们更好的理解这段代码，在执行时，注释并不参与执行，也就是说，代码里有注释和没有注释，对于代码的执行来说并没有任何影响。

注释的种类

🌴 单行注释：格式为// 双斜杠后写注释内容，当注释内容比较少，只有一行的时候，可以用单行注释。

public class HelloWorld{
	public static void main(String args[]){
	//这是一行注释
		System.out.println("HelloWorld");
	}
}
1
2
3
4
5
6

🌴 多行注释：格式为/* 注释内容写在这里 */，当需要注释的内容比较多，一行写不下的时候，就可以用多行注释。

public class HelloWorld{
	public static void main(String args[]){
	/*
	这是一行注释
	我又写了一行注释
	下面我还可以一直写
	...
	*/
		System.out.println("HelloWorld");
	}
}
1
2
3
4
5
6
7
8
9
10
11

🌴 文档注释：文档注释是以 /** 开头， */ 结尾的注释，可以被 javadoc 工具自动识别并提取，在这里我们先不做详细介绍。

注释的注意事项

🌴 注释内容不能包括代码，// 注释的范围是其所在的这一行的后面，所以不能在 // 的后面写代码，但是可以在其前面写代码；使用多行注释时要注意不能将代码包括到/* */中。

public class HelloWorld{
	public static void main(String args[]){
	//这是一行注释
		System.out.println("HelloWorld");//这是一行写在代码后面的注释，但是不能写在代码前面
	}
}
1
2
3
4
5
6

public class HelloWorld{
	public static void main(String args[]){
	/*
	这里写多行注释，如果把代码放到这里就会变成注释，将无法运行
	*/
		System.out.println("HelloWorld");
	}
}
1
2
3
4
5
6
7
8

🌴 尽量不要将注释嵌套使用，单行注释嵌套使用并不会发生错误，但是多行注释嵌套使用可能会发生错误。

public class HelloWorld{
	public static void main(String args[]){
	/*
	这里写多行注释，在嵌套一个多行注释
	/*
	现在这里面有两个斜杠※，和两个※斜杠，但是我们可以注意到第二个※斜杠变成红色
	*/
	
	*/
		System.out.println("HelloWorld");
	}
}
1
2
3
4
5
6
7
8
9
10
11
12

🌴 因为 Java 语法中是不允许多行注释嵌套使用的，所以第一个/*跟第一个*/组成了多行注释，中间的所有内容都变成了注释内容，包括其中的/*也变成了注释，所以剩下的一个*/就会处于失效状态，变成了一个Java编译器无法识别的符号，会使编译发生错误。

🌴 今天是21天打卡计划的第一天，朋友们明天请继续加油！！！