如何在 Eclipse PDT 中重新格式化多行注释？

Posted 2023-02-21

【中文标题】如何在 Eclipse PDT 中重新格式化多行注释？

【英文标题】：How to reformat multi-line comments in Eclipse PDT?

【发布时间】：2010-09-13 01:09:38

【问题描述】：

在Eclipse PDT、Ctrl-Shift-F 中重新格式化代码。但是，它根本不修改 cmets。有没有办法将参差不齐的多行 cmets 重新格式化为每行 80 个字符（或其他）？

即转换

// We took a breezy excursion and 
// gathered Jonquils from the river slopes.  Sweet Marjoram grew 
// in luxuriant 
// profusion by the window that overlooked the Aztec city.

到

// We took a breezy excursion and gathered Jonquils 
// from the river slopes.  Sweet Marjoram grew in 
// luxuriant profusion by the window that overlooked 
// the Aztec city.

（我认为这也适用于常规 Eclipse。）

更新原来Eclipse 在Java 模式下会重新格式化上面的行，但前提是它们是/* */-style cmets。它将缩短 // 太长的行，但不会将太短的行连接在一起。

【问题讨论】：

这些实际上是单行 cmets。多行 cmets 始终使用 /*-notation。

我认为他的意思是跨越多个单行 cmets 的评论。这类事情是在 Python 中进行除文档字符串之外的任何类型注释的典型方式。

【参考方案1】：

您可能需要配置 Java 格式化程序以包含 cmets。

首选项 -> Java -> 代码样式 -> 格式化程序 -> 编辑... -> 注释

确保启用“启用 XXX 评论格式”。

【讨论】：

这似乎在 Java 模式下确实有效，但在 PDT 中却不行。但是，由于某种原因，它只会完全重新格式化 /* / 或 /* */ cmets——它会使 // 过长的行变短，但不会使较短的行变长。

【参考方案2】：

我从来没有真正能够让 Eclipse 格式化程序以我想要的方式完全格式化我的代码，这只是我遇到的几个缺点之一。我听说 Jalopy 格式化程序要好得多。 Eclipse 插件同时提供commercial 和free 版本。我听说商业版更复杂（免费版的开发似乎已经停滞），但我个人并没有真正使用过。

【参考方案3】：

我的解决方案是使用 vrapper 插件（免费）：http://vrapper.sourceforge.net/home/，它为您的文本编辑器提供 vim 支持。

安装 vrapper 插件后，您可以按 v 进入 可视模式，突出显示您的多行评论，然后按 G+Q 自动格式化注释，使行宽为 80 列（默认）。您可以更改默认列宽，但您需要阅读 vrapper 插件的文档。干杯！

【讨论】：

这是最好的解决方案。我正是这样做的，从上面的链接安装了 Vrapper，然后在我的代码中点击 V，选择了被搞砸的块，简单地说：G+Q 固定间距！冲洗并重复代码...然后设置首选项以不再包装它们！