阻止 Eclipse 破坏我的评论答案

【问题标题】：Stop Eclipse from mangling my comments阻止 Eclipse 破坏我的评论
【发布时间】：2010-12-07 23:11:49
【问题描述】：

有没有办法阻止 eclipse 破坏我的源文件中的 cmets？

我的主要问题是阻止它自动换行。我已经设法将 eclipse 配置为不对任何代码进行自动换行，但它似乎仍然对 cmets 执行此操作。

我这样输入的代码：

public int myVariable = 100; // this variable is a very interesting variable and it does lots of stuff

这样结束：

public int myVariable = 100; // this variable
                             // is a very
                             // interesting
                             // variable and
                             // it does lots
                             // of stuff

【问题讨论】：

虽然我通常反对将 cmets 放在代码之后，但问题在其他方面也有效：Eclipse 有时会破坏 Javadoc 中的 HTML 或为成员自动生成的非 Javadoc cmets，这样他们就不会显示相同了。很丑。
@Johannes：关闭所有 cmets（包括 Javadoc）的代码格式很容易
我也反对 cmets after code，但我们的首席开发人员不反对，而且 eclipse 修改代码使得差异文件的更改非常困难。
我听说有人反对 cmets，但是为什么在 code 之后呢？这是宗教吗？
这只是一种愚蠢的宗教偏好（告诉人们只允许战略而不是战术）。如果您有一个非常简短的战术评论，那么将其放在行尾可能是完全有效的。您的替代方法是在上面添加一个全新的行，它占用垂直空间。开发人员经常忽视垂直空间浪费的影响。如果整个方法在一个屏幕上可见，而无需垂直滚动，我认为该方法更容易阅读。战术 cmets 可能有助于实现这一目标。没有理由从工具箱中删除工具。

标签： eclipse comments code-formatting

【解决方案1】：

转到首选项 -> Java -> 代码样式 -> 格式化程序
编辑配置文件并切换到名为“评论”的最后一个选项卡
取消选中“启用行注释格式”

【讨论】：

Tx... 也是一个用于禁用块注释格式的复选框，这正是我想要的...
对我来说，帮助的是“从不加入行”

【解决方案2】：

转到“窗口”菜单 -> 首选项
从左侧列表中选择您感兴趣的编辑器。（例如 Java）
那么应该有一个名为“代码样式”的小节，在那个“格式化程序”下。

然后您需要创建一个新的格式化程序配置文件。（无法编辑内置配置文件）在配置文件配置的最后一个选项卡上是注释格式选项

【讨论】：

【解决方案3】：

您可以使用另一种解决方案来抑制特定块 cmets 的格式设置。在块注释的开头使用 /*-（注意连字符）和格式如果您格式化文件的其余部分，则不会受到影响。

/*- * 这是一个带有一些非常特别的块注释 * 我希望 indent(1) 忽略的格式。 * * 一 * 二 * 三 */

来源：http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-141999.html#680

【讨论】：

最佳响应。应该是答案。
可爱 - 正是我想要的！
不，似乎对 /** cmets 无效。有什么建议吗？
更新了 oracle 文档的 url。 oracle.com/technetwork/java/javase/documentation/…

【解决方案4】：

窗口->首选项->Java->代码样式->格式化程序。创建新的格式化程序。单击编辑，然后选择选项卡注释未选中启用行注释格式和启用块注释格式

【讨论】：

这与@Simon Lehmann 早于您在此处回答的答案相同...为您-1，为他+1。

【解决方案5】：

你可以用<pre></pre>包裹，这个块不会格式化。

/*
 * <pre class="prettyprint">
 * public class Activity extends ApplicationContext {
 *     protected void onCreate(Bundle savedInstanceState);
 *
 *     protected void onStart();
 *
 *     protected void onRestart();
 *
 *     protected void onResume();
 *
 *     protected void onPause();
 *
 *     protected void onStop();
 *
 *     protected void onDestroy();
 * }
 * </pre>
 */

【讨论】：