为什么 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 注释格式 和 启用块注释格式 选项，这意味着我必须手动格式化注释块。

Answer 1

我只能假设这是 Eclipse 中的一个错误。它只发生在 @看 标签，所有 3 个内置代码格式化程序设置也会发生这种情况。

附近已经报告了一些有趣的错误，但我找不到这个特定的错误。例如，参见搜索 @看 在里面 Eclipse Bugzilla.

Answer 2

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

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

我只能假设，就像 Bart 所说的那样，Eclipse 的重新格式化程序中存在一个错误，它认为结束标签实际上是一个自关闭标签。另一个想法：您能否验证一下您的 A 标签是平衡的（即文档上方没有未关闭的标签）？

Answer 3

这可能是 Eclipse 3.4 中的一个错误。我使用的是 3.3 (M20080221-1800)，并且没有观察到此行为。