Java核心技术卷I基础知识3.2　注释

3.2　注释

与大多数程序设计语言一样，Java中的注释也不会出现在可执行程序中。因此，可以在源程序中根据需要添加任意多的注释，而不必担心可执行

代码会膨胀。在Java中，有3种标记注释的方式。最常用的方式是使用//，其注释内容从//开始到本行结尾。

当需要长篇的注释时，既可以在每行的注释前面标记//，也可以使用/*和*/将一段比较长的注释括起来。

最后，第3种注释可以用来自动地生成文档。这种注释以/**开始，以*/结束。请参见程序清单3-1。有关这种注释的详细内容和自动生成文档的

具体方法请参见第4章。

程序清单3-1　FirstSample/FirstSample.java

      警告：在Java中，/* */注释不能嵌套。也就是说，不能简单地把代码用/*和*/括起来作为注释，因为这段代码本身可能也包含一个*/。