java - 为什么 Eclipse 中的 Java 注释颜色不同？

Question

我是 Eclipse 的新手，我正在使用它进行一些 Android 开发。 Eclipse 让我越来越意识到自己养成的不良习惯(即不将类名大写等)。

我注意到的一件事是，当我使用 // 字符进行注释时，文本变为绿色，但是当我使用 /** **/ 字符，文本变为浅蓝色。是否有一个原因？我在某处遗漏了某种评论规范？这些是否应该为不同类型的评论提供不同的功能？

我正在为 Win 7(x64) 运行 Helios Service Release 1(内部版本 20100917-0705)，如果有任何不同的话。

Answer 1

java中以/**开头的 block 注释是javadoc注释。 Eclipse 给它们涂上不同的颜色，使它们与普通评论区分开来。

这是一个讨论如何为 java 编写文档注释的指南:http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html

当您将鼠标悬停在 Eclipse 中具有 javadoc 注释的类/方法/字段上时，您会看到一个小文档弹出窗口，其中包含该类/方法/字段的 javadoc 注释的格式化版本。

您还可以使用 javadoc command-line tool为您的包和类生成 HTML 文档。当您执行此操作时，该工具会使用源代码中的 javadoc 注释来构建文档。