java 注释嵌套_作为Java程序员，你不能忽视的注释方式！

最近听到很多做程序员的小伙伴儿吐槽：从别人那儿接手的代码总是乱糟糟的，完全不知道写的什么！没有标记，没有说明，也没有一行注释，抓耳挠腮也看不懂！

前程序员辞职留下的代码，谁也不愿意接手

这个时候，就需要万能的“注释”大大了！

所谓注释，便是用自然语言对源代码中某些语句或方法进行说明。并且，注释的内容不会被编译器编译。你可以在源代码中添加任何你想要添加的说明，随便多少都可以，只要你不觉得啰嗦。

那么在Java中该如何书写注释呢？有以下三种方法：

一、单行注释

这是最常用的注释方式，注释内容从//开始，到该行结束。

举例：//定义了类的名称

二、多行注释

如果需要注释的内容比较多，一行写不完，如果在每一行注释中都使用//。

当然这种方法比较繁琐，看起来页面也不够简洁。这时候，就需要用到多行注释了。

/*

*多行注释内容

*/

值得一提的是，多行注释还有一种不够简洁的注释方式，那就是嵌套在代码语句中。不过，实际应用的人很少。

三、文档注释

文档注释以/**开始，以*/结束，写入 javadoc文档，生成相应的Java源码的API(应用程序编程接口)文档。

常用的文档注释有以下几种：

注意：

1、多个作者使用多个@author标签，javadoc按照输入时间显示；

2、@param str the String 用来存放输出信息，这里表示输出的str是个整型；

3、@return true 执行成功，输出执行结果；

4、@since jdk1.6 表示编译该文件所需要的JDK环境为jdk1.6；

(关于JDK的版本介绍会在后续的文章中展开，欢迎持续关注哈~)

5、@version 1.0 表示该注释版本的版本号是1.0；

6、@throws IOException 方法抛出了文件读取错误的异常。

7、@deprecated As of JDK1.1,replaced by 表示JDK1.1这个版本已经过期，取代它的是XX；

为了方便理解，小编自己敲了一段代码示例，希望能帮助大家理解！！

到这里，Java里面的代码注释规则就讲完啦！喜欢的朋友们，欢迎来关注猿小花呦~~~