首页 / 知识

关于java:为什么Eclipse代码格式化程序会在Javadoc @see标记中中断</a>?

2023-04-14 07:17:00

关于java:为什么Eclipse代码格式化程序会在Javadoc @see标记中中断</a>?

Why does the Eclipse code formatter break in a Javadoc @see tag?

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

1
* @see test

代码格式化程序在结束的HTML中插入一个空格,将其断开:

1
* @see test< /a>

为什么? 如何阻止这种情况发生?

通过禁用"注释"选项卡上的任何选项(例如"格式化HTML"标记)无法解决此问题。 我发现的唯一解决方法是通过同时禁用"启用Javadoc注释格式"和"启用块注释格式"选项来完全禁用Javadoc格式,这意味着我必须手动设置注释块的格式。


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

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


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


严格的XML规范要求自闭标签在闭斜杠之前应有一个空格,如下所示:

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

我只能像巴特所说的那样假设,Eclipse的重新格式化程序中有一个错误,它认为关闭标签实际上是一个自关闭标签。 另一个想法:您可以验证标签是否平衡(例如,文档中没有更高的未闭合标签)吗?


代码格式化中断启用注释

最新内容

相关内容

热门文章

推荐文章

标签云

猜你喜欢