添加多行注释时如何在 Eclipse 中禁用自动星号（插入星号）？答案

【问题标题】：How to disable the automatic asterisk (inserting stars) in Eclipse when adding a multi-line comment?添加多行注释时如何在 Eclipse 中禁用自动星号（插入星号）？
【发布时间】：2012-08-27 08:25:51
【问题描述】：

在 Eclipse 中添加多行注释并设置格式（Ctrl+Shift+F）时，它会自动在注释块内的每个新行的开头放置一个星号 (*)。

/*
 * this is my comment
 */

这种行为的原因是什么？

如何禁用它？

【问题讨论】：

stackoverflow.com/questions/1641748/… 看到你的答案
请不要那样做。自 C 编程语言诞生之日起，这就是编写块 cmets 的标准方式。像这样打破约定会使其他人（包括自动化工具）更难阅读您的代码。所以不要这样做。请问？
@thkala 我有时会使用星号屏蔽来临时评论我的代码。之后，当我想取消注释时，我无法删除多余的星星。
提交带有“//”代码的代码时，每个注释行都会导致文件发生更改。这是不希望的，应该使用块 cmets 解决。但是，添加的星号也会导致每个禁用的行发生变化。
传统的block cmets很烂。很糟糕。您必须手动取消它们的星号，它们很丑陋，它们没有提供有用的功能，并且它们添加了一堆不必要的空格。每个人都应该摆脱“标准方式”，做明智的事情。

标签： java eclipse comments

【解决方案1】：

这是标准的javadoc format。 eclipse 中的格式化选项在你的项目->properties->Java Code Style->Formatter->Edit->Comments 选项卡上，但我没有看到禁用此特定行为的选项。

【讨论】：

其实是optional for javadoc。但是 +1，因为我也看不到改变这种行为的方法，这与 @Mick 所说的相反。

【解决方案2】：

请不要那样做。

自 C 编程语言诞生之日起，这就是编写块 cmets 的标准方式。像这样打破惯例会让其他人（包括自动化工具）更难阅读您的代码。

如果您需要快速注释/取消注释 Java 代码，可以尝试使用Ctrl+/ 快捷方式。它将使用单行 cmets (//) 注释掉当前行或任意数量的标记代码行。

【讨论】：

我个人希望看到他们离开。它们是optional for javadoc 和 git 在粘贴代码/降价时的方式。所有现代编辑器也以不同的颜色显示文本，因此我们不需要星号来抵消它。
我希望它们消失的原因是快速取消注释 大部分代码。我不想删除每个领先的明星。删除前导符号和尾随符号要快得多。
呜呜呜呜呜呜呜

【解决方案3】：

转到Tools/Options/Editor/Formatting 并选择Language = Java、Category = Comments 并取消选中Add Leading Star。

【讨论】：

【解决方案4】：

在Eclipse 4.2及以后的版本中，解决方法是：Window -> Preferences -> Java -> Code Style -> Formatter ->

$profileName -> 编辑... () -> cmets ->* 取消选中 [ ] 启用阻止评论格式。

请注意，作者要求的是块 cmets (/*)，而不是 Javadoc cmets (/**)。

为了抑制 Javadoc cmets 的前导 * un-check [ ] 启用 Javadoc 注释格式

(*) 如果 $profileName -> Edit... 不起作用，请使用“New...”创建一个新模板。

【讨论】：

【解决方案5】：

在 eclipse 4.2.1 中，我使用了 formatter off / on 功能，请确保不要将 formatter on 标签与 cmets 标签放在同一行，否则星星的噩梦将会回来。

// @formatter:off
/*
Eclipse your * are messing up my comments big time and If I used you
more often I'd put a patch together to add back in the "Add Leading Star" option 
*/
// @formatter:on

必须在 Eclipse 首选项中“打开”开/关功能：Java > Code Style > Formatter。点击“编辑”按钮，“关闭/打开标签”，勾选“启用关闭/打开标签”。

来自

How to turn off the Eclipse code formatter for certain sections of Java code?

还有。我将标签更改为 //off //on 以便于使用

类似的帖子是 How do I turn off '*' in multi-line comments in Eclipse?

【讨论】：

【解决方案6】：

转到Window/Preferences/Code Style/Formatter。在 Active Profile 而不是 Eclipse[Built-in] 中创建一个新的配置文件并单击编辑。

点击“Comments”下拉菜单并取消选中：

启用 Javadoc 注释格式。
启用块注释格式。
启用行注释格式。

【讨论】：