为什么 Eclipse 代码格式化程序会在 Javadoc @see 标记中破坏 </a>？答案

【问题标题】：Why does the Eclipse code formatter break </a> in a Javadoc @see tag?为什么 Eclipse 代码格式化程序会在 Javadoc @see 标记中破坏 </a>？
【发布时间】：2010-09-07 21:46:59
【问题描述】：

我使用的是 Eclipse 3.4，并且已经配置了 Java 代码格式化程序，并启用了 Comments 选项卡上的所有选项。问题是，当我格式化包含以下内容的文档注释时：

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

代码格式化程序在结束的 HTML 中插入一个空格，打破它：

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

为什么？我该如何阻止这种情况发生？

禁用评论选项卡上的任何选项都无法解决此问题，例如格式化HTML标签。我发现的唯一解决方法是通过禁用 启用 Javadoc 注释格式 和 启用块注释格式 选项来完全禁用 Javadoc 格式，这意味着我必须格式化注释手动阻止。

【问题讨论】：

标签： java eclipse javadoc eclipse-3.4

【解决方案1】：

我只能假设这是 Eclipse 中的一个错误。它只发生在 @see 标记上，它也发生在所有 3 个内置代码格式化程序设置中。

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

【讨论】：

【解决方案2】：

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

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

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

【讨论】：

【解决方案3】：

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

【讨论】：