3.2　注释

与大多数程序设计语言一样，Java中的注释也不会出现在可执行程序中。因此，可以在源程序中根据需要添加任意多的注释，而不必担心可执行代码会膨胀。在Java中，有三种书写注释的方式。最常用的方式是使用//，其注释内容从//开始到本行结尾。

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

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

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

警告：在Java中，/**/注释不能嵌套。也就是说，如果代码本身包含了一个*/，就不能用/*和*/将注释括起来。