java - Checkstyle 警告 Eclipse "Javadoc tag should be preceded with an empty line"即使有一个

标签 java eclipse format javadoc checkstyle

我在 Eclipse 中使用 Checkstyle (Google Checks),对于每个 Javadoc 标记,编译器都会显示警告“Javadoc 标记前面应该有一个空行”,即使有一个。消除警告的唯一方法是引入 HTML 换行符。

例如:

     /**
   * shows drinks units in fridge.
   * 
   * @return amount of drinks in fridge.
   */

编译器会给出警告“Javadoc 标签‘@return’前面应该有一个空行”。

当然可以在 Checkstyle 中取消激活警告,但是我仍然想知道编译器为什么会那样做。即使没有换行符,我的老师和同学也没有那个警告,他们不知道为什么我有它,在 Checkstyle ( https://checkstyle.sourceforge.io/apidocs/com/puppycrawl/tools/checkstyle/checks/javadoc/RequireEmptyLineBeforeBlockTagGroupCheck.html ) 的 sourceforge 页面上,也不需要 HTML 响应。

感谢您的帮助!

最佳答案

我意识到这是因为当您按下 enter 时 Eclipse 会自动在星号后插入一个空格(如果您要在该行上写一些东西,这是有意义的)但当您再次按下 enter 时不会删除它。所以 Javadoc 标记之前的行实际上是:<leading indentation>*<space> .手动删除此空格会为我删除 Checkstyle 警告。

也许其他人知道如何配置 Eclipse 来自动删除这个空间。就个人而言,我坚持使用 Google's XML formatter profile因为他们的google-java-format Eclipse plugin不起作用(未处理的异常)。也许 google-java-format 可以解决这个问题。

关于java - Checkstyle 警告 Eclipse "Javadoc tag should be preceded with an empty line"即使有一个,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/69486116/

相关文章:

java - 关于eclipse中的类模板,如何为类创建模板?

java - 是否可以在使用 Java 9 的 Eclipse IDE 中使用没有类和主要方法的 sysout?

eclipse - 为什么EGit有不同类型的 "Team"菜单?

design-patterns - 通用报告格式

java - 你如何计算 java 代码中的操作数,我不确定但有人可以验证我的工作

java - 使用 Java 代码进行 XML 验证

python - boolean 值到小写字符串

javascript - 如何使用JS转换HTML中的日期格式?

java - 如何在不使用apache的情况下在java servlet中上传和保存文件?

java - 将行添加到 DefaultTableModel