警告:悬空Javadoc评论

时间:2017-04-12 16:40:35

标签: android android-studio javadoc android-studio-2.3

自从我更新了我的Android Studio(2.3.1)和构建工具(2.3.1)后,我收到了警告,

  

警告:悬空Javadoc评论

用于评论,

/** set name with format, {@Link FORMAT_NAME} **/
setNameText(getFormattedName(FORMAT_NAME));

正如您所看到的,我使用javadoc样式注释进行链接和其他。我想知道是否有其他评论备选方案具有链接功能。

感谢。

6 个答案:

答案 0 :(得分:8)

当您调用方法setNameText时,您似乎正在使用Javadoc注释。 Javadoc comments要插入 类声明方法声明现场声明

如果您只是在调用方法时需要注释,请使用单行注释:// get formatted name based on {@link FORMAT_NAME}

答案 1 :(得分:5)

您可以在页面中关闭它"文件设置 - 编辑器 - 检查 - Java-Javadoc问题 - 悬空Javadoc评论"。

答案 2 :(得分:2)

您正在使用以/ **开头的Javadoc格式,而不是以/ *开头的块注释格式。

要减轻该警告,请始终在方法内部以/ *而不是/ **开头注释。

答案 3 :(得分:2)

万一它对其他人有帮助,请确保您没有在方法/类定义和对该定义使用的任何注释之间偷偷摸摸的JavaDoc。

答案 4 :(得分:1)

只需更换" Dangling Javadoc评论"用块评论。

答案 5 :(得分:0)

在我看来,此注释的正确位置似乎与方法getFormattedName()相邻,因为您的注释解释了该方法的功能,而不是您调用它的原因。