自从我更新了我的Android Studio(2.3.1)和构建工具(2.3.1)后,我收到了警告,
警告:悬空Javadoc评论
用于评论,
/** set name with format, {@Link FORMAT_NAME} **/
setNameText(getFormattedName(FORMAT_NAME));
正如您所看到的,我使用javadoc样式注释进行链接和其他。我想知道是否有其他评论备选方案具有链接功能。
感谢。
答案 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()相邻,因为您的注释解释了该方法的功能,而不是您调用它的原因。