为什么 Eclipse 代码格式化程序会中断 在 Javadoc @see 标记中？
我使用的是 Eclipse 3.4，并配置了 Java 代码格式化程序，并启用了 Comments 选项卡上的所有选项。 问题是，当我格式化包含以下内容的文档注释时：
* @see <a href="test.html">test</a>
代码格式化程序会在结束 HTML 中插入一个空格，从而破坏它：
* @see <a href="test.html">test< /a>
为什么？ 我该如何阻止这种情况发生？
禁用“注释”选项卡上的任何选项（例如“格式化 HTML 标记”）都无法解决此问题。 我发现的唯一解决方法是通过禁用“启用 Javadoc 注释格式”和“启用块注释格式”选项来完全禁用 Javadoc 格式，这意味着我必须格式化注释手动阻止。
I'm using Eclipse 3.4 and have configured the Java code formatter with all of the options on the Comments tab enabled. The problem is that when I format a document comment that contains:
* @see <a href="test.html">test</a>
the code formatter inserts a space in the closing HTML, breaking it:
* @see <a href="test.html">test< /a>
Why? How do I stop this happening?
This is not fixed by disabling any of the options on the Comments tab, such as Format HTML tags. The only work-around I found is to disable Javadoc formatting completely by disabling both the Enable Javadoc comment formatting and Enable block comment formatting options, which means I then have to format comment blocks manually.
如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱，如果其他用户或者作者回复了您的评论，将不能在第一时间通知您！
发布评论
评论（3）
我只能假设这是 Eclipse 中的一个错误。 它仅发生在 @see 标签上，它也会发生在所有 3 个内置代码格式化程序设置中。
附近已经报告了一些有趣的错误，但我找不到这个特定的错误。 例如，请参阅 Eclipse Bugzilla。
I can only assume it's a bug in Eclipse. It only happens with @see tags, it happens also for all 3 builtin code formatter settings.
There are some interesting bugs reported already in the neighbourhood, but I couldn't find this specific one. See for example a search for @see in the Eclipse Bugzilla.
严格的 XML 规范要求自结束标记在结束斜杠之前应该有一个空格，如下所示：
我只能假设，就像 Bart 所说，Eclipse 的重新格式化程序中存在一个错误，该错误认为结束标记实际上是一个自结束标记。 另一个想法：您能否验证您的 a 标签是否平衡（即文档上方没有未闭合的标签）？
Strict XML specifications require that the self closing tags should have a space before the closing slash like so:
I can only assume, like Bart said, that there is a bug in Eclipse's reformatter that thinks the closing tag is actually a self-closing tag. Another idea: Can you verify that your a tags are balanced (i.e. no unclosed tags higher up in the document)?
这可能是 Eclipse 3.4 中的一个错误。 我使用的是 3.3 (M20080221-1800)，并且没有观察到此行为。
This could be a bug in Eclipse 3.4. I'm using 3.3 (M20080221-1800), and do not observe this behavior.