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

Question

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

/*
 * this is my comment
 */

这种行为的原因是什么？

我该如何禁用它？

- Bobs

---

请查看您的回答：https://dev59.com/XHI-5IYBdhLWcg3w3cc8 - Dinup Kandel

请不要这样做。自C编程语言诞生以来，这一直是书写块注释的标准方式。违反惯例会使其他人（包括自动化工具）更难阅读您的代码。所以请不要这样做，可以吗？ - thkala

有时我会使用星号阻塞来暂时注释我的代码。之后当我想要取消注释时，我很难去除多余的星号。 - Bobs

尝试在Eclipse中使用Ctrl+/。或者选择多行后使用Ctrl+/ :-) - thkala

当提交带有“//”代码的代码时，每一行注释都会导致文件发生更改。这是不希望看到的，应该使用块注释来解决。然而，添加的星号也会导致每个禁用的行发生更改。 - koppor

传统的块注释很糟糕。非常糟糕。你必须手动去掉星号，它们很丑陋，没有任何有用的功能，并且会添加一堆不必要的空格。每个人都应该摆脱“标准方式”，而是做明智的事情。 - Andrew

Answer 1

在Eclipse 4.2及更高版本中，解决方案是：Window -> Preferences -> Java -> Code Style -> Formatter -> $profileName-> Edit... () -> comments -> 取消选中 [ ] 启用块注释格式化。

请注意，作者要求的是块注释（/*），而不是Javadoc注释（/**）。

为了禁止 Javadoc 注释前面的 *，取消选中 [ ] 启用 Javadoc 注释格式化。

---

(*) 如果 $profileName -> 编辑... 不起作用，请使用 "新建..." 创建一个新模板。

- koppor

Answer 2

这是标准的javadoc格式。在Eclipse中，可以通过右键单击项目->属性->Java代码风格->格式化程序->编辑->注释选项卡来进行格式设置，但我没有看到禁用此特定行为的选项。

- Thomas

---

这实际上是可选的Javadoc。但是我+1，因为我也不知道如何改变这种行为，与@Mick所说的相反。 - studgeek

Answer 3

前往工具/选项/编辑器/格式，选择语言=Java，类别=注释并取消勾选添加前导星号。

- Mick

Answer 4

打开 Window/Preferences/Code Style/Formatter。 在当前配置文件（Active Profile）中，不要使用 Eclipse[Built-in]，而是创建一个新的配置文件并点击编辑。

点击 "Comments" 下拉菜单，并取消勾选以下选项：

1. 启用 Javadoc 注释格式化。
2. 启用块注释格式化。
3. 启用行注释格式化。

- shreem kapoor

Answer 5

在 Eclipse 4.2.1 中，我使用了格式化程序的开/关功能，请确保不要将格式化程序标记与注释标记放在同一行，否则星号噩梦将会回来。

// @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 > 代码样式 > 格式化程序。单击“编辑”按钮，“关闭/打开标记”，选中“启用关闭/打开标记”。

从

如何关闭Eclipse代码格式化程序的某些Java代码部分？

另外，我将标记更改为//off //on以便使用

类似的帖子是如何在Eclipse中关闭多行注释中的'*'？

- Robert Verge

Answer 6

请不要这样做。

自C编程语言的第一天起，这一直是编写块注释的标准方式。打破这种惯例会使其他人（包括自动化工具）更难阅读您的代码。

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

- thkala

---

个人而言，我希望它们消失。它们在粘贴代码/Markdown时会妨碍 Java文档注释（javadoc） 和Git的使用。现代编辑器会以不同颜色显示文本，因此我们不需要星号来进行偏移。 - studgeek

我想让它们消失的原因是为了快速取消代码的大段注释。我不想每次都要删除每个前导星号。删除前导和尾部标记要快得多。 - Draco18s no longer trusts SE

Boooooooooooooooooooooo - Andrew