为什么 Eclipse 代码格式化器会破坏 Javadoc @see 标签中的 </a>？

Question

我正在使用Eclipse 3.4，并已启用了Java代码格式化程序的注释选项卡中的所有选项。问题在于，当我格式化包含以下内容的文档注释时：

* @see <a href="test.html">test</a>

代码格式化程序在关闭HTML时插入了一个空格，导致其出现错误：

* @see <a href="test.html">test< /a>

为什么会出现这种情况？我应该如何停止它发生？

禁用“评论”选项卡上的任何选项（例如“格式化HTML标记”）无法解决此问题。我找到的唯一解决方法是完全禁用Javadoc格式，即禁用“启用Javadoc注释格式”和“启用块注释格式”选项，这意味着我必须手动格式化注释块。

- Peter Hilton

Answer 1

我只能假定这是Eclipse中的一个错误。 它仅在@see标记中发生，对于所有3种内置代码格式设置也会发生。

已经有一些有趣的错误报告在邻近地区报告了，但我找不到这个具体的报告。 例如，搜索Eclipse Bugzilla中的@see。

- Bart Schuller

Answer 2

严格的XML规范要求自闭合标签在结束斜杠之前应该有一个空格，如下所示：

<gcServer enabled="true" /> <!-- note the space just after "true" -->

我只能像Bart所说的那样假设，在Eclipse的重新格式化器中存在一个错误，认为关闭标签实际上是自闭合标签。另一个想法：您能否验证您的a标签是否平衡（即文档中是否存在未关闭的更高级标签）？

- Ishmaeel

Answer 3

这可能是Eclipse 3.4中的一个错误。我正在使用3.3（M20080221-1800），并且没有观察到这种行为。

- flicken