如何在java程序中添加注释

1、单行(single-line)--短注释：//…… 单独行注释：在代码中单起一行注释， 注释前最好有一行空行，并与其后的代码具有一样的缩进层级。如果单行无法完成，则应采用块注释。 注释格式：/* 注释内容 */ 行头注释：在代码行的开头进行注释。主要为了使该行代码失去意义。 注释格式：// 注释内容 行尾注释：尾端(trailing)--极短的注释，在代码行的行尾进行注释。一般与代码行后空8（至少4）个格，所有注释必须对齐。 注释格式：代码 + 8（至少4）个空格 + // 注释内容

2、块(block)--块注释：/*……*/ 注释若干行，通常用于提供文件、方法、数据结构等的意义与用途的说明，或者算法的描述。一般位于一个文件或者一个方法的前面，起到引导的作用，也可以根据需要放在合适的位置。这种域注释不会出现在HTML报告中。注释格式通常写成： /* * 注释内容 */

3、文档注释：/**……*/ 注释若干行，并写入javadoc文档。每个文档注释都会被置于注释定界符 /**......*/ ...

注释简单的来说就是一种说明，不能被当成执行语句执行。做为一名程序员，但我们在写代码时是顺着思路写下去的。写代码好比就是在做题。当你在做的时候你脑海时的思路很清晰，会想到用一些特殊的方法来解决当前的问题。但是但你在解决一个大型问题时。思路有很多，而且有的比较复杂，现在你现写代码时，自己心里清楚自己为什么要这么写。但时隔几天或几个月，当你再次打开你所写的代码时。你会发现一大堆代码看下来整个人会晕头转向的。会忘记当时所写的部分代码的功能或实现过程。简单的说就是会忘记当时的思路。

而这时注释的作用就显示十分重要了。当你在写代码时。写到关键部分你可以写下一些说明（注释），说明你的思路或此段代码的功能和作用。当有了这些说明，你时隔几个月再回来看自己曾经写的代码时就能快速找回当时的思路，快速理解代码。值得提的时。以后在工作上，往往是团队合作。今天你写了几个代码。明天可能你请假，另一个人来接手你的工作。接着你的代码写下去。但如果你写代码时用到了一些别人不知道的思路时。如果没有注释，别人根本就很难理解你的代码。也就难以接手你的工作了。

说以上这些只是为了让楼主能明白注释的重要性。好了。下面正面回答楼主的问题：

上面说到。代码中可以加以注释来说明自己所写的代码的作用。在Java中有单行注释，多行注释，和文档注释。

（1）单行注释：以“ // ”开头后面接所要加的说明的内容。如下面所示：

//定义变量a

int a = 10

//定义变量b

int b = 20

上面的语句中，在编译的过程就会直接略过注释，只会编译 int a = 10 和 int b = 20这两句。由此可见注释只是起着说明的作用。

（2）多行注释：以“/*”开头，以“*/”结尾。

假设当你要说明你所写的代码的功能时。要说明的内容有很多。如果全部放在同一行会显得很难看。所以一般会用多行来写，如下所示

// 说明

//说明

//说明

//说明

以上是用四个单行注释来注释四行说明。但如果有10行说明就要按十个“//”这显示很麻烦，所以这时就可采用多行注释。上面的可改成：

/*

说明

说明

说明

说明

*/

也可以这样

/* 说明

说明

说明

说明 */

（3）文档注释：以“/**”开头，以“*/”结尾。文档注释主要是生成文档的。楼主刚学Java可能不知道什么是API文档。因此，这里我就不说明了。以后你自然会明白。

好了就这些了。希望能帮到楼主，祝楼主学习愉快！O(∩_∩)O哈哈~

注释是用来给开发者或者是软件后续的维护者来看的。一般是用来描述这一段代码或者是程序做了些什么样的事情。实现了哪些功能，java里面注释代码，可以分为行注释和块注释，方法注释等。

行注释就是在需要注释的代码前加 //

块注释则是用 /* 和 */ 把文本段落框起来即可

---